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PREFACE 


TThis book is intended to give you an introduction to the C language. It is not meant to 
be, and is not designed to be, an expert text or master handbook. 


What it is designed to do is to get you quickly and easily programming in the C 
llanguage. It is then up to you to go on and learn the language in full. 


“The book has been designed to be used mostly by people working at home or in an 
«office by themselves on a micro system. Probably, they will be working with Turbo 
«C, although they may bc using one of the other C compilers. They will, though, find 
iit easier to follow the examples if they are using Turbo C. 


. As this book is an introductory tutorial I have strictly limited the functions included 
‘and the scope of the book. It is hoped that cover has been given to all the main 

"functions which you are liable to need for most user programming. Coverage is not 
given to those aspects of the language more of use to the systems programmer. These 
can be looked up once you have a basic understanding of the language. 


To use this book you should have access to an IBM PC or compatible computer and 
the, Turbo C compiler. The programs in this book were developed and tested on a 
Handwell Baby AT and Handwell XT provided by AM Components of Coventry, 
England, and an Amstrad PC1640HD20 provided by Interspike Intersoft, Apeldoorn, 
The Netherlands. 


Finally, this is a Turbo C tutorial. It is not a replacement for the Turbo C manual. If 
you do not have a manual, you do not have a legitimate copy of Turbo C. That is a 
shame. You need the manuals to get the most out of one of the best implementations 
of C under MSDOS. : 


Nigel G. Backhurst 
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BACKGROUND TO C 


The C language is a mid-level general purpose programming language which was 
developed by Dennis Ritchie in the early 1970s at Bell Labs. This statement raises the 
question, What is a mid-level language? 


At the most basic level the way you give instructions to a computer is by way of 
machine code. Machine code is a series of binary numbers which are understood by the 
microprocessor as instructions. Such instructions form the lowest level of computer 
programming languages. 


Such low level programming presents problems for the programmers. Binary machine 
code is not the easiest thing to write or read. It is, in fact, not a very practical method 
of programming due to the difficulty of dealing with binary numbers: 


00010110 
00101100 
10110011 
10001101 
01000011 
10111110 
10000111 


If you have to try and debug binary code, as shown above, you have problems; trying 
to work out what it is doing is virtually impossible. 


Fortunately, we have been saved from the problem of trying to talk to computers in 
binary code by the development of hexadecimal code, although this makes the problem 
only a little easier. It was made much easier by the introduction of assemblers. With 
assemblers, instead of having to give each instruction to the computer in a numeric 
form it is possible to give it in a symbolic form. A special piece of software, the 
assembler, then assembles this symbolic set of instructions into actual machine code. 


There are still problems with assemblers and these are due to two facts. First, the 
system must be told every step that has to be undertaken. This results in the 
programmer having to write quite a lot of code. A second problem is that the code 
written is specific to one processor and one hardware configuration. 
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The high level languages like Fortran, Cobol, Basic, Pascal and Comal provide a 
programmer with a set of instructions which are easier to leam. These languages are far 
more like the English language with one instruction covering a number of steps. There 
is, of course, a price to pay for all these benefits. 


In general, the high level languages are less powerful than the low level languages. 
This is because they do not provide you with the ability to undertake the direct 
manipulation of the computer's memory and processor registers as do the low level 


languages. 


There is a small group of languages which provide you with a programming 
environment which is fairly portable between systems, yet gives you a great deal of 
power. As these languages lie in a hierarchy between the low level languages and the 
high level languages they are referred to as mid-level languages. 


Of these languages, C is probably the leader today. There are some computer people 
who claim that C is the only true mid-level language. That is a view which I do not 
support. Others claim that BCPL and Forth, together with a handful of specialist 
languages developed for real time programming and communications software like 
PLM, are also mid-level languages. This I support. 


So, let us consider the advantages and disadvantages of having a mid-level language. 


"The main advantage is that they combine many aspects of the high level programming 
languages, such as data types, control statements and structured forms, with the 
flexibility and efficiency which are normally associated with assembly languages. This 
provision of facilities associated with assembly languages is clearly found in the wide 
range of operators which C supports for working on the bit structure of data, an 
operation far more at home in the world of assembly language programming than n the 
world of high level language programming. d 


However, C does not supply many of the features which would be expected from man 
high level languages. It has no I/O or file handling functions defined within ie 
language. There are no direct facilities for dealing with string variables, array sets 
lists. These facilities have to be added to the language by means of function hires » 


"This does mean, though, that the language c 
NE ans. Wo an be very compact. It has only a few 


pere these have been under review as 

pepe ^s new standard for C, the proposed ANSI standard. Under dU 
tions have been made to the basic set. Turbo C supports th iti 

aa ea eal ese additions plus 


H 


A compact language means 


CES ou have ich i 
EU x T d one which IS easy to use and also one which is 


to use facilities built into the. 


femore portable as there is less chance of 


lation USA 


In Tables 1.1, 1.2 and 1.3 are lists of the Turbo C reserved words.. These are divided 
into three sections. First, the classic C reserved words. That is, those reserved words 
which are found in versions of C which provide a full implementation of the old 
Kernighan and Ritchie standard. Second, the ANSI additions which will only be found 
in versions of C which follow the proposed ANSI standard are shown. Finally, the set ` 
of reserved words which are special to Turbo C are given. 


Table 1.1 Classic C reserved words 


auto break case char continue default 

do double else extem float 

for goto if int long register 
return short sizeof static struct switch 

typedef union unsigned while 


Table 1.2 ANSI additional C reserved words 


const enum signed void volatile 


Table 13 Turbo C extension reserved words 


asm cdecl far huge interrupt near 
pascal _CS .DS MES _SS _AH 

AL _AX . BH BL CH CL 
_CX DH DX .BP DI SI 
_SP 


Having a very compact language does have some disadvantages. C can be very cryptic 
at times. It is possible to write C in what is almost a short-hand way using 
multistatement lines and maximum abbreviations. When this is done it can be almost 
impossible for anybody other than the programmer to read the code. It can also, at 
times, produce some very bad code. 


Many programmers have the idea that the shorter they make the code for a program, and 
the more cryptic it is, the more efficient it must be. Whilst this is sometimes the case, 
it is not always so, and often highly cryptic code is highly inefficient. This is because 
the programmer has written code which has the shortest form on paper and not that 
which is the most efficient. 


With modern compilers like Turbo C, the need to write very short code is vastly 
reduced. Turbo C has an efficient optimizing function in its compile process and will 
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optimize code to an extent beyond that of the average, or even good, programmer. This 
means that Turbo C can be (and is) very efficient. Well thought out code correctly 
structured and implemented can often approach assembler in performance. In some 
cases, a piece of well written Turbo C can actually beat a poorly written piece of 
assembler code, and it is far easier to write good code in Turbo C than in assembler. 


The fact that it is easier to write code in C than in Assembler gives us another major 
benefit from using Turbo C. With its integrated development environment and built in 
Hi debugging facilities, program development time is drastically reduced. The man/hour 
M A effort to produce source code in C is much less than that required to produce similar 

| i source code in assembler. The man/hour effort required to produce finished code in 
Turbo C is far less than that required with many other compilers which are on the 
market. 


i The one advantage of using C which is widely praised is that C is highly portable. 
h Well, in theory it is. In practice, it is not very portable, but for most modern 

i i programming, portability that is not very important. First, let us look at the theory. 
| | If you stick to the ANSI proposed standard and Classical C reserved words, and use only 
j the basic standard function library then your code should be portable. But even then 
ME you could have some surprises. Even very basic library functions like getchar() can 

A | work differently and unexpectedly under different compilers. For instance, the standard 

| 1 usage of this function is that it returns the value of the key depressed and echoes it to 
the screen. This is how Turbo C implements the function and how it is found under 
Al Unix. On many MSDOS and CPM compilers you are required to press the RETURN 
T" key after the key depression before getchar() operates. Differences like this can pose 
i problems of portability. 


| Even more problems can be expected once you start to make use of any of the special 

extensions within a language. Turbo C is specifically designed for the MSDOS 
environment and has extensions and functions within it to support that environment 
i These are not found in other compilers, Any functions using them would have to be 
| rewritten if you were moving the code to another compiler on another system. There is 
H little point in moving to another compiler under MSDOS. In ; 


E ee - ractice, as many of 
these extensions are so specialized i i : Piece’? y 
Us pec it might be impossible to re-write the functions 


In general, such lack of portability is not a 
people using Turbo C is designed to run on the IBM PC a ; 

; E : z nd i 
neither expectation nor desire for it to be run on other systems, em De 
that your Turbo C code is portable. There is a compile time option which will onl 
compile ANSI standard reserved words and produce an error on any Turbo C ony; 
By using this you can make certain that yo extensions. 


problem. Most software being written by 


u have portable code, 


The ANSI Standard 


The ANSI standard is referred to above. At the time of writing a committee of the 
American National Standard Institute is drawing up a new standard for C. Draft 
proposed standards have already been issued. 


Until recently, most compilers have been based on the description of the C language 
given in The C Programming Language by Kernighan and Ritchie. This is a very 
good book and one which any serious C programmer should possess. It does have a 
major fault from the point of view of being a standard for a language: it was not written 
as such. It contains of description of C, but not a definition of it, so, many of the 
aspects of how C should work have to be taken by implication from the description. 
Unfortunately, there is enough scope for interpretation of that description to result in 
some conflict concerning how C should be implemented. 


Since the publication of the draft ANSI. proposed standards the trend has been for 
compilers to follow the new draft proposed standards. These are fully supported by 
Turbo C. 


A Short History of C 


It is worthwhile for users to have some background on what C is and where it comes 
from. 


The history of C starts in 1972 at the Bell Laboratories in the USA, where Ritchie was 
working on a development of the B language. B itself was a language derived from 
BCPL which started life at Cambridge University in England. 


This was the time when Thompson and Kernighan were busy developing the Unix 
operating system and had already implemented it on a PDP 7; they now had the task of 
moving it over to a PDP 11. Having once written the Unix operating system in 
assemble- ihe PDP 7 they were not too keen on the idea of having to do the whole 
thin{ .4q A to? Set it across to the 11 and any future computer to which they might 
want .. it. Therefore, it made sense to write as much of it as possible in a higher 
levellanguage. Fortunately, Ritchie was working on a language intended to undertake 
such work. 


After some reworking of C to make it more suitable for systems work it was used to 
write the first port of Unix. Since that time most of Unix has been written in C. 
Only that part of the Unix system which handles the software/hardware interface is 
written in assembler. This means, of course, that Unix can quickly and easily be 
transported between different machines. It has also meant that there is a very close 
relationship between C and Unix. 
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There are some aspects of C which programmers who have never worked ona Unix 
system tend to find quirky. These generally reflect something about the operation of a 
Unix system. One aspect of this is the way that the C standard library I/O routines 


tend to be biased very much to output on a TTY. This is because 1t is the most basic 
type of output and the only one you can presume to have on any Unix system. 


With the expansicn of Unix into the academic world and the impact this has had on 
computer training, C has become a widely taught language in Computer Science 
Departments. 


Nowadays, it is the main language used for software engineering. In fact, it is often the 
only language known to many of the younger software engineers in the industry. 


For the foreseeable future C will no doubt remain the leading software engineering 
language and the main programming language on modern computer systems. However 
it may not become the ‘be all’ language which many people like to think it will be. It 
is interesting to note that even now as C is starting to become popular many of the 
more specialist programmers who embraced C in the late 70s and early 80s are moving 
to other languages, and that Forth, a much neglected language (albeit in an altered form) 
is starting to make a reappearance for application program development. 


The introduction of Turbo C with its integrated development environment is an 
indication of a new role for C. It is now clearly emerging as a primary software 
development language for application software. It is no longer an esoteric tool used by 
high level programming experts. 


The reason for this is that the Turbo C development environment provides far more 
extensive support for the programmer. It is important for making the writing of good 
C code easy for the software writer, fully supporting the writer with extensive libraries, 


fast compile times, efficient and extensive error checking, and most important of all, a 
clear message system. 


T'asn. 
he funct 
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PROGRAMMING 


Many readers will find that this chapter covers familiar areas. You may feel that you 
can safely skip it. Don't. 


In this chapter two aspects are covered. First, the basic concept of what a program is 
and how these are developed. Second, the terms used in this book are introduced. It is 
important that when the terms statement and expression are used, readers understand 
what they mean. 


One of the problems in the computer world is that the use of language tends to be very 
flexible. A term can mean one thing in one context and another in a different context. 
Terms such as jumps, calls, blocks and structures can have very different meanings 
according to when and how they are used. This chapter aims to define the basics of. 
how such terms are used in this book. 


First, let us consider what a computer program is. It is a set of instructions which the 
computer can understand and follow, which result in the computer undertaking a 
specified series of actions in relation to inputted data. 


Computer programs are made up of statements which consist of a combination of 
commands and expressions. So, first we must define a command and an expression. 
Essentially, a command is an instruction to the computer to carry out an action using 
data. An expression is an instruction to the computer to carry out an action on data. 


If I give the instruction: 
add A to B and place result in C. 

that is an expression. In the C language it would be written as: 
c =a tb; 

If I give the instruction: 
take the value of C and display it on the screen. 

that is a command. In the C language it could be written as: 


printf ("%da",c) ; 
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that is, they are instructions given to the system. In 
However, 


f the two. I could give the instruction: 


Both of the above are statements, ; 
this case, the statements contain either a command or an expression. 


statements can contain a combination 0! 


add A to B and display the result on the screen. 
That is a statement which contains an expression and a command; in C it could be 
written as: 


printf("$d", a + b ); 
Any computer program is made up of a series of statements. 


It is all very well having a series of statements for the computer to follow, but what 
you need is to get the computer to follow them in the correct order. One way in which 
you can do this is to put the statements into a preset order so they are always carried 
out in the same order every time the program isrun. Such a series of statements would 
be as follows: 


Get two numbers. 
Subtract the second number from the first. 
Display the result. 


This approach is fine provided you want the same set of operations carried out each 
time: but often you do not. Look at the above example again. If we wanted the 
difference between two numbers and we wanted this as a positive figure, the above set 
of instructions would let us down if the second number was larger than the first. In 
such circumstances we would need to have a different set of instructions carried out. 


This can be done by using what is known as flow control statements. These are 
statements which cause the order in which statements are executed to be amended 
according 5 the ER of data held in the system. In fact, they may prevent certain 
statements from being executed at all. So, let us look at an am i 

. 5 end 
EM. nile ed version of the 


Get two numbers. 

If the second number is less than the first. 
Subtract the second number from the first. 
Then display the result. 

Otherwise. 

Subtract the first number from the second. 
Then display the result. 


Here is a situation where if one condition is true, that i 
l , that is that the second number is less 
than the first, then a set of statements is carried out. If it is not true another set of 


statements is undertaken. According to the state of the data in the system, the action of 
the program will be modified. 


There are two types of modifier you can use in controlling the flow of a program. The 
first is the.branch. In this, if a condition is met one set of actions is carried out, 
otherwise another set of actions is carried out. 


ACTIONS 


ACTIONS 


Figure 2.1 The branch . 


The second type of modifier is the loop. Actually, a loop is a special type of branch 

which causes the flow of the program to go round and round in circles until a specific 

condition is met. There are two types of lop: those where the condition is tested at 

the start of the loop, start tested loops, and those where the test is made at the end of. 
the loop, end tested loops. — ' 


Programming languages can be divided into two classes: lineal languages and block 
languages. C belongs to the latter type, although it is possible, and occasionally 
desirable, to program in C using a lineal approach. 
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START TESTED 


ACTIONS 


END TESTED 
ACTIONS 


Figure 2.2 The loop. 


ACTIONS 


ACTIONS 


oe] | 


ACTIONS 


FALSE 


Figure 2.3 Lineal Structure 
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À lineal program is one in which the statements to be executed follow each.other in the 
order in which they are to be executed. Any modification to the order is undertaken by 
jumps forward or back in the program. 


There are two problems with lineal programming. The first involves all those jumps 
backwards and forwards. It can become quite difficult to keep track of where you are in 
a program structure with a number of jumps. In a complex program any attempt to 
draw a diagram of the program flow can end up looking like spaghetti, which is why 
many programmers call such programming spaghetti programming. This can result in 
code which is very difficult to debug. 


Another problem is that any commonly used routine must be rewritten every time it is 
used. This amounts to a tremendous amount of recoding and increases the chance of 
errors. 


The alternative approach is to use block structures. Here, all the actions undertaken in 
a program are broken down into a set of basic actions. These make up individual 
blocks which can then be called up by blocks at a higher level. So, in a block structure 
program you have a top level block which contains a series of calls to lower level 
blocks and which passes data to them. The lower level blocks then process that data 
and return the results which can be used in the next call. 


One advantage of this approach is that when a commonly used routine exists it only 
needs to be written once and can be called from a number of blocks. So a single block 
may be called by more than one block from a higher level. 


There is one point which must be made clear. Programming books, magazines, and 
courses generally place a great deal of emphasis on structured programming and using 
blocks. This is quite right. However, it is a common mistake to say that lineal code 
isalways wrong. There are times when it is better than even the best block structure. 


One example of this is where speed is important. It takes time to do a call to a routine. 
pass the data to that routine and get the data back. Quite often the time taken to 
undertake the call can be greater than the time taken to do the processing. In such 
circumstances there is good reason for using a lineal program structure. 


While you should use a block structure ap 
lineal approach where factors like speed 
simple. 


proach as much as possible, do not ignore the 
are important or where the program is very 


— M 


Jumps are one of the easiest ways of getting lost in a program and should therefore be 
avoided as much as possible. Some programmers even go so far as to say you should 
never use them. That is possibly an extreme, but their use should be kept to a 
minimum. 


START 
FIRST 
—4 


LEVEL 
MAIN Pel AUS ROUTINE SECOND 
ROUTINE RE 4 
» =< UTIN 
y 
SECOND 


À FIRST m] LEVEL 
a X-| LEVEL ROUTINE 


ROUTINE 
—— 


SECOND 
LEVEL 
ROUTINE 


Tee SECOND 
FIRST AE LEVEL 
Eee PEEVE — —] ROUTINE 


ROUTINE 

SECOND 
LEVEL | 
ROUTINE 


FIRST 
LEVEL 
ROUTINE 


SECOND 
LEVEL 
ROUTINE 


ENT. 


SECOND 
LEVEL 
ROUTINE 


Figure 2.4 Block Structure 
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3 


THE STRUCTURE OF A C 
PROGRAM 


Every C program consists of one or more functions. Each of these functions performs 


its own tasks. The results generated by these tasks are passed between functions in 
several ways. 


In any C program you must have one function which is called main(). This is the 
entry point to your program. It is the.point from which the program starts when it is 
invoked. There is no rule in C which states that the function main() has to be the first 


function in a program, although generally itis. You can put it anywhere you like and 
some programmers prefer to put it as the last function in a listing. 


In Turbo C each function consists of: 
A heading 


This includes: 
The function name. 


A list of arguments passed to that function, 
Type declaration. 


A block 


This includes: 
Local variable definitions. 


Statements which may include calls to other functions 


enclos ithi 
Fi itn Within braces, Such groups of 


Given the above, a C program will have the f 
ollowing type of s 
tructure: 


M 
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e * 


Global Definitions 


main() 

{ 
function1(); 
function2(); 


) 


functionl() 
( 

statements; 
) 


function2() 
{ 

statements; 
) 


This, of course, reflects the type of structure known as a block structure and discussed 
in Chapter 2. Have a look at Figure 3.1. 


function-one(); 


function-two(); 


) 


function-one() statements 


{ 


expression; 


expression; 


function-two() 
{ 


expression; 


expression; 


statement 
terminater 


Figure 3.1. 
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If you consider the example program you will see how such a structure is applied. 
/* Example program to show basic structure. */ 


main() 
{ 
messagel (); 
message2(); 
) 


messagel() 
{ 

printf("Hello this is a simple C program \n"); 
} 


message2 () 
{ 


printf("We hope that you will find this tutorial useful.\n"); 
} 


Enter this and run it. If you are working from within the Turbo C development 
environment you can do this direct. It is done either by using Alt-R, or from the main 
menu. To invoke the main menu use F10. For more details on this you should 
consult the User's Guide. 


In this program you have three functions. The prime entry function main() and two 
secondary functions, messagel() and message2(). The two functions are called up by 
the statement lines in the block of the function main(). 


The functions messagel() and message2() make a call to a standard function called 
printf() passing a line of text to that function as an argument to be printed. You should 
note that printf is a standard function which is supplied with C, it is not part of the C 
language itself. 


If you look at the lines of text passed you will see that each line ends in a special 
character combination ^"W', In C the backslash character "v escapes the following 


character giving ita special meaning, in this case the status of a newline character. So 
`n’ means print a new line. Some of 


a the other special character combinations in Turbo 
\t tab 
\b backspace 
\\ backslash 


A complete list can be found in Chapter 8 of the Turbo C User's Guide. 


At the start of the Program there is a comment tellin 


DOE i à g us what th gram i is i 
enclosed within a pair of special signs, these are /* and */. ip Ee Uhisis 


—-———— nne 


You can place comments across more than one line if you need to. The only thing 
which you have to be sure of is that they start with /* and end with */. The following 
is a valid comment: 


/* 
This is a demonstration of the setting up of comments. 


This tutorial was written by Nigel Backhurst. Nigel worked mostly 
on a Handwell Baby AT and a Handwell PC 8088 which were supplied 
by AM Components of Coventry and an Amstrad PC. 


*/ 


Perhaps not a very helpful comment, but still a good illustration of placing comments 
over a number of lines. 


When you are using comments you must place the */ at the end. If you do not, the 
compiler will ignore all the code which follows the comment until it finds the next */. 
This, as you will no doubt find out, is one of the most common mistakes made by C 
programmers. 


There are a number of ways in which you can avoid such mistakes. ‘They all come 
down to one basic rule: establish a standard form for your comments and stick to it. In 
this book a well tried style of commenting is used. This is not the only correct way to 
comment your source code; there are other equally valid methods. However, this 
system does work and you might like to follow it, or to work out your own variation. 


Where a comment is given outside a function I like to include it in a comment block. 
The opposite corners of the block are formed by the comment start and comment end 
markers. An example of this would be: 


[OI e e e e e e III e AE HEEE E E e AEE OK XXI ICI IO SIO IS IIIS 


* This routine is used to check that the command x 
* entered is a valid command. The check is done by* 
* seeking a match for the command letter against a * 
* letter in the valid command string. 5 


GIO OI IO IOI IOI IO IO IOI IOI III I I IOI III 


If there are comments inside functions these can be dealt with in two ways. The first is 
to put a single comment line after the statement to which it refers: 


lpi = malloc( strlen( buf ) ); 
/* Get space to copy buffer into. */ 


There is a problem here that interspersing comment within code can make the code 
difficult to read. Another method which I prefer is to offset the comments to the right 
of the code. In this case a line of * is placed down one side of the comment as in the 
following example: 


while ( TRUE ) 
( a 


ee e es ) break; /* Endless loop. Keep 
* testing until the 
* space bar is pressed 
* then break out. 
"vu 


An advantage with this type of commenting is that it is fairly easy to write tools to 
check the comments. Basically, the rule that such a tool should look for is that if there 
is not a comment cancellation on the same line as the invocation then an * must exist 
on each line until the cancellation is found. When you have finished this tutorial you 
might like to have a go at writing such a tool. 


Commenting style is a very personal matter. It is important to find a style which suits 
you and to stick to it. This wilt mean that any break from the normal can easily be 
seen. If this practice is adopted, mistakes with comments are less likely. 


A further point about comments is that normally you cannot nest comments. The 
result of this is that if you wrote the following code: 


/* This function is to be excluded 


delay( int time ) 

{ 
ie alnoj 
for ( i = 0; i < time; i+¢ ) 
/* Empty loops */ 


for ( j = 0; j « 1000; j++ ); 
) 


unless the delay is required. */ 


fea not work. The */ in the empty loop comment would be taken as the end of 
e comment, and the second part of the delay loop and the second f th 
would both produce errors. Part of the comment 


There are times when it might be useful to be 

p : able to comme i 
With Turbo C this can be done. Th RA s : : nt out sections of code. 
nested comments. Generally, such practi meee pme option which allows use of 
sections of code, it is best to do this b 
is covered later in Chapter 23, 


A point to note about declaring functions is th ; 
within a function. The following would be ates function cannot be declared from 
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main() 


( 


int fnumber, snumber; 


fnumber = 3; 
snumber = 5; 
print mes(); 


print mes () 


( 
printf("\nThe value of the two numbers added is, "); 


) 


printf ("%d\n", fnumber + snumber ); 


because we have tried to define the function print, mes() from within the function 
main(). The legal way to write the above program would be: 


main() 


{ 
int fnumber, snumber; 


fnumber = 3; D 
snumber 577 


i} 


print_mes(); 


printf ("%d\n", fnumber + snumber ); 
} 


print mes() 


( 
printf("\nThe value of the two numbers added is "); 


) 


Here the function print mes() is the same, but this time it is declared outside the 
function main(). 
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"bytes ) are going to be required to store 


NAMES, VARIABLES AND 
CONSTANTS 


Variables and Constants - Definition 


Computer programs deal with data held in the computer. This data can be of two types: 
variable values and constant values. 


A variable value is: 


A value which may change during the run of a computer program. 


A constant value is: 


A value which does not change during the run of a computer program. 


Memory Storage 


Data values are stored by the computer in its memory. An easy way to visualize this is 
to imagine the memory being made up of many little boxes, It can be thought of as 
being somewhat like the old-fashioned ‘pigeon hole’ system which was used for holding 
mail. If you look at Figure 4.1 you will see such a representation, 


All data is held in the computer as numeric values. Each box can hold i 
from 0 to 255. This is shown in Figure 4.2, ara me 


This is fine provided you only want to store values u i 
p to 255 in memory., If 
to store a value more that 255 you cannot do this in one box. In Sich CRM 


X holding a value Up to 255. This is shown in 


You have to tell the compiler how many boxes ( or to be more technically correct 
the values which you will be placing into 
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y i i ithin the 
memo i d declarin variable values wit 

ry. This is done b defining constants an B 

program Each variable must be declared to belong toa specific type 


Values over 255 are Split across two or more 


bytes each holding up to 255 


Both bytes contain the value 1, the number 256 being made up of 1 from the 
low order byte + 1 + 255 from the high order byte 


Figure 4.3 


The C programming language supports a num 


ng la ber of different types of variable. Tc 
start with, we consider just three: the int, char 


and float. 


ers, On other systems, the one ag ee Be 
storing ints, or other variable types may be different, nt of space u 


The variable type char stands for character These include the letters of phabet, the 
digits used to write numbers, punctuati nd 5 Ce nde 
red in memory as numeric 
ave no direct connection with the 


s ion marks, space a 
characters which exist on your system, All charac 


values. To confuse things, the value Stored ma 


ters are Sto 


character. For instance, the character ~1' is stored as the value 49, whilst ^9' is 57. In 
fact, ali characters are stored in accordance with their ASCII values. 


Characters have a numeric value in the range 0 to 255. This means that they can be 
stored in a single byte. 


The variable type float stands for floating point. These are numbers which have a 


decimal point, the position of which changes according to the value represented. Not 
all C compilers support this type of variable, but it is fully supported in Turbo C. 


Variable Declaration 
The declaration of a variable can take place at a number of different points in a program. 


The point at which a variable is declared will affect the scope of that variable. We look 
at this later. The form of a variable declaration is always the same: 


type identifier ; 

Identifiers 

Each variable, or for that matter constant, has to be given a name. This name is 
associated with a specific set of bytes and is used by the compiler to identify that set of 
bytes. It is therefore known as an identifier. 

There are some specific rules covering identifiers. These are: 


Identifiers must begin with a letter or an underscore character (_ ). 


They can only be made up of alphanumeric characters and the underscore 
character. 


The Turbo C compiler, in common with most C compilers, treats upper and 
lower case letters as different. This is the C standard. There are a few older C 
compilers which do not follow this standard so care must be taken when 
moving source code from old systems. 


No identifier can be the same as a keyword. 

Each identifier must be unique. 
With regard to the last point, although many compilers only recognize the first eight 
characters and some recognize fewer, Turbo C will recognize the first thirty-two 


characters of an identifier as being unique. This is in keeping with the newer standards 
for C. 
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There can be a source of problems here if you are trying to move code from one 
compiler to another. This is particularly true if you are moving code written for one of 
Pe the older C compilers to Turbo C. In one case where I was moving code across, it 
bi M would not compile. It took many hours of debugging before I found that the problem 
1 N was that the original compiler for which the code had been written only recognized the 
Í first eight characters as being significant. This meant it regarded next_line_current and 
t next_line_held as being the same. Turbo C of course, recognized them as being 
different. This is in keeping with modern C practice. There is an easy way to avoid 
this problem if you come across it. You can set the number of characters to be 
significant as a compile option. See page 198 of the Turbo C User's Guide. 


If you are not using Turbo C it is a good idea to run a check to see what your compiler 
will allow. The compiler check program will undertake this. 


/* Compiler Check */ 


main () 
{ 
float number; 
/* Check compiler supports floating point variables */ 


int firstnum; /* Carry out check to see if the 
* compiler differentiates between 
* upper and lower case characters. 
e 


int FirstNum; 


int | newnum; 
/* Check for allowability of lead underscore */ 


/* The following check is for number of unidue characters */ 
int ab3; j 
int ab34; 

int ab345; 

int ab3456; 

int ab34567; 

int ab345678; 
int ab3456789; 
int ab34567890; 
int ab345678901; 
| int ab3456789012; 


ing one of the older C compilers you will probably get 
ould be able to tell the specific aspects of your 
w the limitations of your compiler. 


Assigning values t 


Values are assigned to variables using the assign operator =. The nature of the value 
assigned will depend on the type of the variable. 


/* Demonstration of assignment */ 


main() 

( 
int number; 
char letter; 


number 
letter 


1; 
‘At? 


printf("\nThe number is *d ", number ); 
printf("the letter is $c Wn", letter ); 
} 


In this example we have the declaration of two variables. The first is an integer 
variable called number. The second is a character variable called letter. This is 
followed by the assignment of values to the variables, the value on the right of the 
assignment operator being assigned to the variable on the left (see Figure 4.4). In this 
case we have the value one being assigned to the integer number and the value ‘A’ being 
assigned to the character letter. 


VARIABLE 


VALUE; 


THE VALUE ON THE RIGHT OF THE OPERATOR IS ASSIGNED TO THE 
VARIABLE ON THE LEFT 


Figure 4.4 


a 


In the final part of the program the printf() functions are used to output the results of 
the assignments. 


You do not have to assign a specific value to a variable. You can assign the value of 
another variable. Have a look at the following program and see if you can find out 
what the final values of fnumber and fletter are. When you have worked it out, enter 
and compile the program to see if you were right. 
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We have introduced something slightly different in this program. Here, instead of 
declaring each variable on a separate line, we have done all declarations of one type on 
| iF one line, the identifiers being separated by commas. This is a multiple declaration. 


/* Assignment of variable values */ 
main () 


{ 
int fnumber, snumber, tnumber; 
char fletter, sletter, tletter; 


i fnumber = 1; 

i snumber = fnumber; 

jd tnumber = snumber + fnumber; 
fnumber = tnumber; 
fletter - "a"; 
sletter - "b"; 
tletter = sletter + 1; 
fletter = tletter; 


printf ("\nfnumber 
printf("\nfletter 


%d ",fnumber); 
sc ",fletter); 


nod 


} 


` As you have no doubt found out, this is a little trap in the above program. If you look 
at the first part it is fairly easy to follow. The value of 1 is assigned to fnumber. This 
means that fnumber is now 1. The value of fnumber is next assigned to snumber. 
This gives you a value of one for snumber. Now the value of fnumber and snumber are 
added and the result assigned to number. This results in a value of 2 for tnumber. 


Finally, we have the assignment of the. value of number back to fnumber. So fnumber 
ends up having thie value two. 


A d 


All this you should have found fairly easy to follow. Now for the more difficult part, 
the letters. 


p UL ee 


The value ‘a’ is assigned to fletter. A has the ASCII value 97, so fletter therefore is 
given the value-97. Next, the value of 'b' is assigned to sletter. The character 'b' has 
an ASCI value of 98. The assignment to tletter is the trick, though. Here we have 
the assignment of the value of sletter, which is 98 plus 1. The result of this is that the 
value 99 is assigned to tletter, which is the ASCII value for 'c'. The final stage of 
assigning the value of tletter to fletter gives fletter the value of 'c'. 
Coming back to the multiple declaration of variables at the start of the i 
can save you quite a bit of typing when entering code. It is often pene ag 
if the variables are declared separately. With good compil 


make no difference to the size or performance of the final eode ? © this should 


PN eI ee 


Turbo C and most good compilers support the ability to ‘initialize’ variables in one 
Statement. That is, to declare the type of the variable and its value at one and the same 
time. In such cases you get a statement such as: 


int anumber = 7; 


However, it should be noted that many compilers do not support this. In such cases, 
two statements have to be made to achieve the same result: 


int anumber; 


anumber = 7; 


Constant values 


Often within a program you will have certain values which are used over and over . 
again. These can be stored as a variable. Another approach to handling such values is 
the preprocessor directive #define. 


#define 


Let us settle one point before talking about the #define directive. Many programmers 
tend to think that this works something like defining constants in other high level 
languages. This, in fact, is not the case. 


With the #define directive, a definition’ is given to a token. During the compiling 
process, whenever the compiler meets that token it will replace it with the text held in 
the definition. It will then continue compiling, reading the new text. In many ways 
this is similar to a search and replace operation in text editing: All references to one 
thing are changed into a reference to something else. 


One of the main uses for this is in the case of constant values which are used in a 
program. If we say: 


#define GIANT 7 


then every occurrence of GIANT in the source code at compile time will be replaced 
with 7. 


There are three parts to using #define. First, the preprocessing directive #define. There. 
should be no gap between the # symbol and the word define. Some compilers will 

accept such a gap but most will not. For the sake of safety it is best to get into the 

habit of not putting a gap. 


Second, comes the alias. This is the text which will be put into your source code. 
Finally, comes the replacement text. You will notice in the above example that we do 
not put a semi-colon at the end. Anything following the alias is taken as part of the 
replacement text, that includes semi-colons, quotation marks, etc. 


z 
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As the #define directive undertakes a replacement of the text before the compilation of 
that piece of text, it is possible to use itas a means of inserting any standard text, not 
just for constant values. Thus, it can be used to provide an easy way of entering much 
used but complex statements, SO reducing the risk of typing errors during compilation, 


For instance: 


#define TAGLINE "The current situation in $10s is \ 
currently running at %d $$ over the figures for $d.Nn" 


means that foz everywhere else in the source code that we want this text all we have to 
do is enter the alias TAGLINE, eg: 


printf (TAGLINE, country,gross, year); 


We have used the \ to escape the carriage return at the end of the first line of the 
#define. This will result in the compiler viewing the two lines as one. Such 
procedures allow us to define fairly long pieces of text for replacement. 


In theory, you can use the #define directive anywhere outside a function. In practice, 
you are advised only to use it at the start of a program, immediately after any #include 
directives. We look at those later. 


There are two reasons for placing #define directives at the start. First, the main reason 
for using #defines is so that if a value has to be changed you only have to do it once in 
your source code. it is far easier if they are all together at the start when you come to 
changing values. A second reason is that, although Turbo C will support #defines 
anywhere outside functions, many compilers will not. If you need to produce portable 
code it is best not to presume you can use #defines elsewhere in your source code. 


It is said that C is a standard and highly portable language; somebody should have told 
the compiler writers. Fortunately, with Turbo C, Borland provided the information so 
that you can make your code portable, but you will need to read both the User's Guide 
and the Reference Guide to make sure you write portable code. 


Pointers. — 


CIC oM e aspects n C which tend to cause major problems for people 
le e language. is is especially the case f i 
languages like BASIC which do not make use of pointers. T e uM 


What pointers are is explained here, althou i 
c 3 7 , gh not in any de th. á : 5 
conceming pointers come up during the course of the book We 2n e i. topics 


When you first make use of a variable, an area of the 

e : computer's memory i to 
hold the values which you allocate to that variable. Note that thi ie ee gue 
many other languages. The memory is not taken up M DE 


yi until use i iable. 
With many languages the memory is allocated as soon as the TOUR Coh di 
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On a standard MSDOS system an integer variable is stored as two bytes in the memory 
of the computer. So, if you have, at the start of your program, the line: 


int num one - 10; 


somewhere in the memory of the computer two bytes are reserved to hold the value 
allocated to num one. The location at which this memory is reserved is an address 
which has an integer value, If you want to refer to this address you can do so by 
putting the address operator, an ampersand (&) in front of the variable name, eg: 


&num one; 


which means the address of num one. This can be seen in Program 001 which you 
should enter and try. 


On the system used to test the software this returned a value of -10 as the memory 
location at which the variable num one was stored. Different values will result 
depending on the system used is set up. 


[ROK IT II FIO II IOI OI IO I IO IOI III IOI I I Ie. 


* Program 001 R * 
x Demonstration of memory address operator * 


CR Y kc kk kc kk kc kc ke ko kk kk kk kk kk kc e ke Ck kk e ke oko kk ok Rok IOI kk ke f. 


main() 
( 
int num one - 10; 


printf("\nThe value of num one is %d Vn",num one); 
printf("The address of num one is %d Vn",&num one); 


The memory location will always be an integer number. 


As you can refer to the location in memory where a variable is stored you therefore 
have two ways of addressing any variable in memory. First, you can use its name. 
The second method is to use the location of the variable in memory. This is done by 
assigning the memory address to a class of variable known as a pointer. Pointers are 
indicated by having an asterisk (*) in front of their name at declaration. 
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int num one - 24; /* 24 stored in memory x 
int *ptr; /* pointer */. 


&num. one is the address of where the value is stored. 
In this case, 6. 


ptr = &num one; 


ptr is therefore equal to 6. 


* ptr is the value held at location 6, which is 24. 


Figure 4.5 
eee 


So, if we want a pointer to num_one we can have Program #002. 


[AOR kk kk kk kk ke kk kk ke kk KO kk kk TOI ek kk oko k kk Ok GIC ICI nn 


* Program 002 x 
* Demonstration of memory address operator and x 
* pointers. * 


CC Ck KO OK OK OK OK KK OK Ck Ok Ok RK kk ke Ok Ok Ck Ck Ck ck k C CK Ck KK KK OKCK CKCKCK OX Ck Ck kkk / 


main () 
{ 
int *p_one; 
int num_one = 10; 
p one = &num one; 
printf("\nThe value. of num one is $d Vn",num one); 
printf("The address of num one is %d VWn",&num one); 
printf("The value of p one is $d \n",p.one); 
printf("It points to the value of num one $d Nn'Z5pNone)rr 
) 


In this program the address of num. one is assigned to the pointer p one. The first 
printf() line prints out the value of num one. The second prints out the address of 
num one. Next, we get the value held in the pointer ( note you do not use the * here ). 
This is followed by the value pointed to by the pointer. In this case, as you want to 
point to something, you use the * to indicate the nature of the pointer. 


The question of why pointers are useful is considered later in the book. For the time 
being just try and understand what they are. 


There is one other factor which you need to keep in mind about pointers. They behave 
differently from normal variables when you carry out incremental or decremental 
operations on them. Have a look at Program 003. 


J[ ECKCKOKCk Ek kk RC ke kk kk IOI CR kk OK XCOKOK IOI IOI I IOI RIK ITR OEC KORG OK 


* Program 003 S 
* Incremental effect on pointers x 


Ck ck ck Ok OK OK Ok OK OK eee OK OX OK OK OK OIX OK OC OK KOC OKOK OX Ok OR Ok Oe XO OC eee eee 0 e X f 


main() 
( 
int f num, *p one; 


f num - 0; 
p one = &f num; 
while ( f num < 5 ) 


{ 
printf("Current value of f num is $d \n",f num); 
printf("Current value of p one is $d \n",p one); 


f num = f num + 1;' 
p one = p one + 1; 
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In this program we start with the declaration of two variables. One f num. is of type 
"integer. The second p one is a pointer to type integer. The value 0 is assigned to 
f. num and the address of f num is assigned to p. one. 


Next, a loop is set up in which the current values of both f num and p. one are printed 
out and then the values are increased by adding one. All you have to do is enter 
Program 003 and run it. 


You will find (as could be predicted) that the series of values printed for f. num will be 
0, 1, 2, 3, 4. You may be surprised when you look at the values for p. one. This will 
be different on different systems, but on my system I got -10, - 8, -6, -4, -2. What you 
should find is that the value of the pointer is increased by two, not by one. 


The reason for this is that when you increase or decrease a pointer, the pointer carries 
out that increase or decrease in the number of units appropriate to the class of the 
pointer. In our case we were pointing to an integer on an MSDOS system. Under 
Turbo C these occupy two bytes. Therefore, if you wish to increase the pointer to 
point to the next variable of this type in a sequence stored in memory you have to 
increase it by two bytes. The compiler automatically does this for us so that when I 
add one to the value of p. one it takes this to be one unit which for an integer pointer is 
two. 


This should be remembered at all times when you are working with pointers. If it is 
not, you can find yourself faced with problems because the increase occurring is not 
what you expected. 


The const Modifier 


The const modifier is one of the three modifiers defined in the proposed ANSI standard. 
The other two are signed and volatile. The signed modifier is dealt with next, but the 


volatile modifier is really outside the scope of this book. Information on it can be 
found in the Turbo C User's Guide. 


The const modifier is used to define an object as being unalterable. In fact, it makes it ' 
have a constant value. In classic C this was not possible. If you had a constant value 
in a program you could deal with it in three ways. 


First, you could enter it in full at each point it was used. This did produce extensive | 


- typing and an increase in the chance of typographical errors especially i | 
m eh à A » as 
- fairly long like that of pi. Consider the following example: E c 


The second method was to use the #define directive as discussed earlier in this chapter. 
So you could use: 


fdefine PI 3.1415926 


at the start of the program and would use: 
area = PI * radius ^ 2; 


in the code. This does have the advantage that it saves all the typing and significantly 
reduces the chances of a typographical mistake. However, it does have a disadvantage 
in that when the program is compiled the macro is expanded to the full value of pi and 
itis stored as a constant at each use. Now pi is a float, so it takes up four bytes. If 
you have it occurring 300 times in a program, that is over a kilobyte of code just used .. 
to store one set of values. Not very good if you are working with a restricted memory. 
(By the way, if you think 300 occurrences of one constant is a bit heavy, I have come 
across one piece of code where the value of pi had to be used over 2,000 times.) 


A third way was to declare pi as a variable. This saved memory. However, it had the 
disadvantage that there was always the chance that it might be amended by mistake. 
That is something which you do not want to happen to a constant. . 


The const modifier gives you a way around this. You can declare an object as you 
would a variable but modify the declaration so that it is declared const. So your 
declaration of pi will read: 


const float pi - 3.1415926; 


This means that although we can now use pi in an expression as if it were a variable, 
we can do nothing to it which would change its value. 


The const modifier can be applied to all types of values, ints, floats, doubles, characters 
and pointers. 


The signed and unsigned modifiers 


Another addition from the proposed ANSI standard is the signed modifier. This isa 
counterpart to the unsigned modifier which is found in classic C. First, we will look at 
the operation of the unsigned modifier. 


A normal int variable can contain values from -32768 to 32767. Often, though, you 
will have situations where you will never need to store a negative value in a variable. 
In such cases you can declare a variable as being unsigned. Then it can only be used to 
store positive numbers; in the case of integer variables, numbers from 0 to 65535. 
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There are certain types of variable under classic C which were always unsigned. These 
were the character variables. The reason for this is that they were needed to hold the 
ASCII character set plus the extensions which occupy the values from 0 to 255, that is, 
the-values which can be held in a single unsigned byte. 


In practice, character variables are often used to store low value numbers, especially the 
single numbers from 0 to 9. This is fairly common, especially in applications which 
are handling many small numbers and where there is a need to save memory. To be 
able to declare a ch» acter variable as a signed variable and store negative numbers in it 
is therefore most useful. i 


With the Turbo C compiler you can decide whether you want to have your character 
variables default to signed or unsigned type. The standard default is to signed. 
Whichever type you use you must be certain of specifically modifying your declaration 
to either signed or unsigned when you are making use of variables specifically in a 
signed or unsigned role. 


From the point of view of documentation and as it makes life easier (in that you do not 
have to bother to make sure you have the correct compiler option set to the mode you 
require for the compilation) it is probably best always to declare variables to be either 


signed or unsigned. This is the practice which we will follow from now on in the 
tutorial. 
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5 


WORKING WITH 
FUNCTIONS 


In the last chapter we looked at functions briefly. Now we consider them in more 
depth. 


A function is a self-contained set of instructions which carries out a specific task within 
a program. A C program is made up of a series of these functions. There is a theory 
in C programming that no function should carry ct more than one task. In practice, 
this is not always desirable or possible. 


Each C program must have a function called main(). This is the entry point to your 
program. It is the function within which you normally set up the top level of program 
flow control. 


There is no rule which says that you have to put the function main() at any specific 
place in the source code. Nonetheless, it is good practice to put it somewhere where it 
can be found without difficulty. This will make life much easier for you when you 
need to debug it or amend it. The tradition is to put main9 as the first function in your 
source code. However, there are some programmers who like to pat it at the end of the 
source code. The choice is yours, you can put it wherever you like: just make sure you 
always put it in the same place. 


Variables and functions 


Variables which are declared outside of functions are known to all functions following 
their declaration. In theory, you could declare variables outside functions anywhere you 
like in the code. In practice, it is best to put all such declarations at the start of the 
Source code. 


As the variables are known to all functions, such variables are said to be global to the 
program. They are therefore known as global variables. 


Variables which are declared within a function are known only to that function. Such 
variables are said to be local to the function. They are therefore called local variables. 


An important point here is that if you have two variables of the same name in two 
different functions, they are different variables. This is illustrated in Program 004. 
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* Program 004 
* A demonstration of local and global variables 
eo ee ee ee ck k Ck k ee ee kck ck k ck k k X k koX / 


k 


unsigned int mas_num; /* Variable declared global */ 


main () 

{ 
unsigned int a num;  /* Variable declared local */ 
a num = 5; 
mas num - 10; 


first fun(); 
second fun(); 


printf("End of main mas num - $d, ",mas num); 
printf("a num = %d\n ",a num); 


) 
first fun() 
( . 
int a num; /* Variable declared local */ 


a num = 4; 
printf("Nnmas num = %d\n", mas num); 
mas num = mas num + a num; 


printf("mas num = %d\n", mas num); 

printf("a num = %d\n", a num); 

printf("This is the end of first fun Vn"); 
) 


second fun() 


( 


int a num; /* Variable declared local */ 


a num = 3; 
printf("Nnmas num = %d, a num = %d\n", mas num, a ana) A 


mas num = mas num * a num; 


printf("mas num = $d, a num = %d\n",mas num, 


a ü 
printf("This is the end of second fun Xn"); . num); 


If you enter this program, compile and run it, 


the last value printed for the variable a num which is first declared in m 


you will find that at the end of the run 
ain() is the 


assigned to it in main() because it is defined outside the functions. It is a global 
variable. 


Coming back to a point which was made earlier, you can declare a global variable under 
Turbo C at any point in the source code. You should remember though, that it will 
only be known as a global variable to those functions which follow the declaration in 
the source code. The fact that global variables are not known to functions which 
precede them can occasionally be useful. Not often, but do not dismiss it. The rule is 
that global variables should be declared at the Start of the program. 


Remember that the art of good programming is to follow the rules; the art of brilliant 
programming is to know when to break them. 


The ability to make use of both global and local variables gives a great deal of 
flexibility to the handling of values within C. It can also present a difficulty. Often 
you want one function to know the value associated with a variable in another function 
but you need to keep the variables local. : 


Function Arguments 


One way in which this can be done is by the passing of arguments to functions. An 
argument is a value which is passed from one function to another in the call to the 
second function. Have a look at Program 005. 


[KOC kCK ke kk OK RC DE e IOUS III OOOO IO III IIIA I 5.56 ee te se de 


* Program 005 * 
* Demonstration of function arguments * 
SOI I IIIT IIIS II IIT TA TIA IES A ATA RD 
main () 


{ 
int f number, s number; 


f number - 5; 
Ss number = 6; 


calc( f number, s number); 


printf("Nnf number = $d, S number = %d\n", f number, S number); 
) 


calc( int num 1, int num 2 ) 
{ 
int r_num, s_num; 


printf ("num 1 = d, num 2 = $d \n", num 1, num 2); 
r num = num 1 + 5; 
S num = num 2 + 7; 

37 


CC-0. Gurukul Kangri University Haridwar Collection. Digitized by S3 Foundation USA 


printf("r num = $d, s num © $d Nn", r num, S num); 
di num 1 = 0; 

num 2 - O0; 

printf("num 1 = $d, num 2 = $d Vn", num 1, num 2); 


) 


Here we have a nice illustration of argument passing. In the first function main() we 
declare two local variables f number and s number, assigning values to them. A call 
is then made to the function calc(). In this call the values f number and s number are 
passed as arguments. 


In the second function calc(), we receive these arguments as num. 1 and num 2. Note 
that we declare the type of these variables in the function argument list. This is in 
keeping with the new ANSI standard which is supported by Turbo C. In the older Cs 
the variables would have to be declared immediately after the function name line. So 
the start of our function would read: 


calc( num 1, num 2 ) 
int num 1, num 2; 


( 


Turbo C will support this method of function declaration if required. It can be 

confusing at times to come across both types of declarations for passing arguments. It 

is my view that where possible it is best to use the ANSI form and declare the passed 

f variable in the function declaration. This removes the chances of making a mistake in 

"Ws the declaration list, which was a common form of error under the older compilers. 
Hn d Also, it allows the compiler to undertake more checking at compile time. 


2 AS num ] and num 2 are declared inside the function they are local variables. 
LOS Anything done on them will not affect f number and s number in main, although the 
Hin Nes values assigned have come from those variables. 


We now go into the block of the function calc(). Here we declare two more variables 


then carry out a series of operations displayin i i i 
i g the results with the funct 
This shows the passing of the values and their resetting. 27 et aa 


Finally, we retum to main() and using the function pri j 
nd i printf(), confi 
f number and s number are still in the form in which we D dn" beue or 


There is, of course, more argument pass 
function printf(). Here we are passing, 
have printed out. 


ing in here: the passing of the argument to the 
as an argument, the material which we want to 


Returning Values 


Sometimes you want to return a val i - 
making use of the keyword retum. value to the calling function, You can do this by 


E: 
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The return command also has another function. It can be used to cause a function to 
terminate and return control to the calling function, whether or not the function has 
finished. 


First, we will look at the case where it is being used to terminate the operation of a 
function. 


[RRR I kk kk ko kk kk kk kk X CKCk Ck ckock KK CK KO ke kk ck Ko KK 
* Program 006 x 


* Demonstration of return from a function A 


FOCI ICICI E E E E E E e E E E E OI OI IOI II III / 


#include <stdio.h> 


main () 
{ 
printf("\nThis is now calling the function \n"); 


first fun(); 


printf("\nNow we have returned to the main function. Wn"); 
) 


first fun() 

( 
char a char; 
int a num; 


a num = 0; 
while ( a num « 10 ) 
( 
printf("\ntd Enter a letter : - ", a num); 
a char = getche(); 
if( a char == 'q' ) return; 
a num = a num + 1; 


Here is a program which will keep looping until either a lower.case 'q' is pressed, or it 
has looped ten times. A test is included for the detection.of the lower case 'q. When it 
is detected the return takes us back to the function main(). 


The rule with return is that when it is encountered, the program will return to the 
calling function. 


Now have a look at Program 007. 
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* 
* Program 007 
; * 
ad * Demonstration of return of a value 


MU IEEE EKE KERERE EEEE / 


include <stdio.h> 


main () 
{ 


int f_num; 


printf("NnThis is now calling the function Nn"); 


f num = first fun(); 


printf("NnNow we have returned to the main function. \n"); 
printf ("You took $d trys before returning.\n",f_num); 


) 


first fun() 

{ 
char a_char; 
int a_num; 


i a_num = 0; 
while ( a_num < 10 ) 
{ 
printf("\n%d Enter a letter : - ", a num); 
5i a char = getche(); 
ub if( a char == 'q' ) return ( a num ); 


LU t a num = a num + 1; 


) 


In this second example, the value a; num is returned to the function main() where it is 
assigned to f num. Here you can see the use of a function call as one side of an 
assignment. This is something which we had already used with the getche() function. ` 
The value to be returned is placed in brackets immediately following the retum 
keyword. Note that we leave a space between return and the opening bracket. This is 
done to clearly indicate that return is a keyword and not a function. 


A couple of small points about return which brin i 5 

! e of t turn. gS up again the subject of 

UR Ud between compilers. First, in the theory of classic C, return Q should 

be the same as return. At least, that is what the text books say. In my experience this 

= no [A ES oe ee of compilers will flag return () as an error. This is 
e action taken by - As a result of this if i dines 

to be returned you should use just return. BRL oborta vile 


There is a very good reason for this approach. It all 

i k ows Turbo C i 
level of error checking. If there are brackets then a value m En c ES 
compiler can check if a value is expected and that one is being returned. B 


a 


The other question is that of brackets around the returned value. In fact, these are 
optional under Turbo C which will accept both: 


return a num; 
return (a num); 


as being valid. There are some compilers that insist on brackets. It is, therefore, safer 
to use brackets, and this makes the code easier to read. 


A final point about the above programs. You will notice that we have used the 
command: 


#include <stdio.h> 
The file stdio.h is a special file which contains certain standard definitions and define 


directives. The command #include tells the compiler to read this file and include it as 
part of the program. 


Pointers 


Another method of transferring values between functions is by pointers. They are very 
much more versatile than arguments and return values. They are also more complex. 


Class and Variables 


In addition to type, that is the nature of a variable, C variables also have a quality 
. which is called class. The nature of a variable's class defines how long it will exist and 
maintain its value. 


eU of C variable: static a 
understand thi: is to say that an auto varia 
has been fi edes | vhilst a static vari bl 


practice, all variables other than global va wes ec automatically declared as auto 
unless otherwise specified. Therefore, if you wish to declare a variable inside a function 
as static tha st be done specifically. 


Program 008 displays the difference between auto and static variables within a function. 
This program is fairly straightforward. The interesting point is in the function 
increment. Here, the variable integer f. num is declared and initialized to zero. It is of 
type auto. The variable s. num is not initialized; it will automatically be given the 
value zero on the first call to the function. After that it will hold whatever value it had 
when you left the function last. 
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* 


* Program 008 - ds i 
* Demonstration of automatic and sta 


x 1 " a 
* variables in functions 
KK RCK CR eK CIO IO TO II IIR III II ee / 


* 


LESEZIIII 


main() 
initi i ari * 
int count = 0; /* Declare and initialize local variable / 
while ( count « 10 ) /* Start loop */ 
{ 
printf("\n count = %d ",count); 
count = count + 1; 


increment (); 


increment () 

{ 
int f_num = 0; 
static int s num; 


f num = f num + 1; 
s num = s num + 1; 


printf("f num = $d, s num = %d Mn", f num, s num); 


Register Variables 


There is a third form of variable: 
are a third class of variables, but 
automatic variable. 


the register variable. Technically, register variables 
It Is easier to think of them as a modified form of 


The actual workings of a register variable are Teall 
therefore beyond the scope of this tutorial. Bri 
function to be a register vari 


If you do feel that you need to make use 
Reference Guides and some of the Standard 


€—————— 


Type and Functions 


All functions have a type. This is dependent on the type of the return value of the 
function. By default, the type of any function is int. If a function has a type other 
than int, then this must be specifically known to the function calling it. This can be . 
done either by declaring the function globally so that it is known to all functions in the ' 
program, or by declaring it specifically in the calling function. There are two ways in 
which such a function declaration can take place. The first is the method used in classic 
C. This is fully supported by Turbo C. In this form the declaration of a function takes 
the form: 


type function name(); 


So if we have a function called words, which is returning a pointer to a character, our 
declaration of that function would be: 


char *words(); 


One fact about this is that no information is given about what arguments, if any, are 
required to be passed to the function. This means that there is no way in which the 
compiler can check for you that the right number of arguments have been passed to the 
function. To overcome this the ANSI extension supported by Turbo C contains the 
option to prototype functions. The form to do a function prototype declaration is: 


type function name( argument list ); 


so in our example we could have: 


char *words( char vowels[], char noun(] ); 


Also, as we have seen , Turbo C supports full function definitions. This means that 
rather than having the classic C declaration for the function word in the form: 


char *words( vowels, noun) 
char vowels(]; 
char noun(]; 


( 


we can make use of the fuller function definition which allows far more error checking 
on the part of the compiler of the function call: 


char *words( char vowels[], char noun[) ) 


( 
Even where prototyping has not been used, the fuller form of the function declaration 


allows the compiler to undertake a higher level of error checking than with the more 
traditional C style of function definition. 
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There is, however, a problem with this. If you are writing code which has to be 
portable to other systems there is a chance that you may find that the older compiler on 
that system will not support the new form. Fortunately, Turbo C supports both 
forms. This means that if you need to write portable code, then you can still use the 
older and less efficient form of declaration for functions. 


The Void Type 


As described above, the presumption in C is that every function returns a value. The 
function has the type of the returned value. If this is not declared then the value is 
presumed to be of type int. Many functions do not have any return value. It was the 
custom with the older versions of C to define a type VOID using the ildefine expression 
in the form: 


$define VOID int 


This meant that if you had a function declaration you could make it clear that it was not 
returning any value by including the VOID word. This, on compilation, would be 
expanded to int so making no change: 


VOID delay() 
( 
int i; 
foe ( 1 2 9 gx S Me itt ) 


) 


In Turbo C, in keeping with ANSI, there is now a new standard type. This is the type 
void. The easiest way to think of this is as a null type. If you have any function 
which does not return a value then it should be declared as being of type void. You can 


also use void to show that no arguments can be passed to a function, so with the above 
example we would have: 


void delay( void ) 
{ 


Another useful aspect of the type void is that it can be used to handle untyped pointers. 
These are pointers which are returned by functions, but do not point to a specific type 
The most common form is that which is returned by the function ate and which 
actually points to a block in memory. This block may be of any size. In classic C 
these pointers have been declared as type char *. (They had to point to somethin s0 
saying they pointed to a single byte worked.) With the introduction of the E 


"you can now declare them as being of type void *. This has been done in Turbo C 


with many of the routines such as malloc() which handle memory blocks 


One advantage of using the void pointer is that you can assign its value to pointers of 


other types without having to cast i ; l 
MN QUU Tis was something which you often had t 
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SOME INPUT AND OUTPUT 


One task which you will need to perform in any language is to handle the input of data 
to your program and the output of data from it. In this chapter we introduce some of 
'the basic functions used. 


printf() 


You have already come across the printf() function in the demonstration programs. 
Until now, we have not given any explanation of what it is or what it is doing. 


The function printf() is a member of the standard function library of the C language. 
Being a print formatting function, printf() provides us with a very powerful way of 
outputting data. Incidentally, print formatting means that it will format your output 
according to the specifications you give the function in the call to it. 


To use printf(), you have to send it two arguments. The first of these arguments is 
mandatory. This means that it must always be included. It is known as the 'control 
string' although for some reason people have now started to use the term format string’ 
to describe it. This latter is the term used in the Turbo C documentation. The control 
string can be either a string contained within double quotation marks, or a pointer to a 
string. 


The second argument is optional. Its use will depend on the contents of the format 
string. It isa list of variables, which are to be formatted and included in the printout.’ 


First, let us consider the use of printf() with just a control string: 
printf ("Hello."); 


In this case everything within the double quotation marks will be printed. As a general 
rule with printf() everything inside the double quotation is printed. However, there are 
two exceptions to this. These are the cases where either escaped character codes or 
format control directives are used. 


Escaped character codes are a set of characters which are given a special meaning by 
being ‘escaped’. That is, removed from their normal meaning. In C this is done by 
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directives. 


An 
Nr 
Nt 
"NS 
NIE 
NO 
\<character> 
\nnn 


\xHHH 


\a 


The 


The escaped character codes are: 


It would be no use you giving the call: 


printf("The \n is used to generate a new line."); 


is used to generate a new line. 


What you have to do is escape the \ so that it is ignored by the compiler. To do this 
_ you precede it with a backslash. So what you will have is: 


printf("The \\n is used to generate a new line."); 


ìe applies to the other symbols which have special meanings. A list of these is 
on page 201 of the Turbo C User's Guide. One point here is that this list 
the si gle quote (apostrophe) and the question mark. Although these characters 
ial meanings which in some circumstances have to 
statements. 


preceding the character with a backslash. They are, therefore, often known as backslash 


Linefeed or Newline 

Carriage retum 

Tab 

Backspace 

Formfeed 

The NULL value 

Ignore any special meaning given to the character. 
Where nnn is a three or less digit octal number that 
value is passed as a control character. 

Where HHH is a three or less digit hex number that 
value is passed as a control character. 

The ASCII code 7, the audible bell or buzzer. 


Most of these are fairly clear in their usage. Indeed, you will be very familiar with the 
\n directive which has been used in the example programs. The one aspect of the 
backslash directive which does cause problems is the escape mode when it is used to 
escape a special meaning which C gives to a character. 


For instance, if we want to print a backslash in a piece of text we experience problems. 
The way around this is to escape it. If you wanted to print on the screen: 


The \n is used to generate a new line. 


as C would treat your \n as a backslash directive and what will be printed is: 


be escaped, this is 


If you have any characters which have special meanings being used inside the control 
string which you intend to be printed, then you will have to escape them. For 
instance, if you wanted text displayed inside double quote marks you would have to use 
the backslash so that: 


printf("The answer was given \"That's right .\""); 
would produce: 
The answer was given- "That's right." 


This can be confusing to start with but you will saon get the hang of it, and if you 
want to program in C you will have to! 


A final point with regard to the escaped characters: the Va and the \xHHH form part of 
the new ANSI standards. They are not found on many older compilers. If you want to 
use these make sure you are using Turbo C. 


Format control directives are preceded by a % sign. They are therefore often known as 
percent directives. 


The % sign is used to tell the printf() function that it has to print a value at that point 
in the text. This value is obtained from the list of values given as the second argument 
in the function call. 


The type of value which will be printed is indicated by a letter which follows the % 
sign. Before looking at those there is one point to consider. The % sign has a special 
meaning in printf() function calls. If you want to actually print the % sign in your text 
you have to handle it in a special way. Unlike the other special characters you do not 
escape it with the backslash. To print the % sign you must put in two of them. That 
is 9596. In this case, the % directive is used to escape the % sign. Therefore: 


printf("The dividend is expressed as a $$ of gross."); 
will print: 
The dividend is expressed as a % of gross. 


Now on to value types. 


td will print an integer value. 

%C will print a character value. 

&f will print a floating point value. 
zs will print a string. 

o will print an octal value. 

&x will print a hexadecimal value. 
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For each of the percent directives which appears in the control string there must be a 
corresponding value in the value list. The values in the value list must appear in the 
same order as the associated percent directives in the control string. 


This means that if the first percent directive in the control string is a character percent 
directive and the second is an integer percent directive, then the first value in the value 
list must be a character value and the second an integer value. Have a look at Program 
009. 


[I III FR ORT IO TO k kk k kk XCK KO KO X CK k k C 


* Program 009 p 


* Demonstration of printf() * 
KKK KK KR kk kokCKCk Ck kCk kCkCKCKCk KCXOKOX Ck XCk CK X KCk Ck KC K X X Ck X ko x / 


main() 

( 
char a let; 
int a num; 


amet = "at; 
a num = 1234; 


printf("The letter = $c, the number $d \n",a_ let,a num); 


The printf() function allows you to include many formatting commands. One useful 
aspect of the percent directives is that you can include flags to tell the function how to 
print the values. These can specify the field size, left or right justification and form. 
The field size and justification can be very useful if you are working in columns. 


You specify field size by placing a numeric value between the % sign and the 
designation letter. If the numeric value is unsigned then the value will be printed right 
justified. If the minus sign is included to indicate a negative value then it will be 
printed left justified. If the field size designation is preceded by a 0 then the field will 
be zero filled. s 


Note that if you give a field size which is smaller than the amount of Space required for 
the value, then the field will be expanded to make space. Consider Program 010. 


If you enter and run this you will get the following results: 


Justify to the right The number is :1234 
Justify to the left The number is :1234 
Cut it to 3 places The number is :1234 
Zero fill to 7 places The number is :0001234 


y cin Ek EARRA EAEE AE N a 


x program 010 * 
* Demonstration of field setting in * 
* printf() functions * 


Lk C RC EROR R QE RA ORE LAGARDE DRAK RENI N D EDAD 


main() 
{ 


int a num = 1234; 


printf("Justify to the right (B) B 
printf ("The number is :57dNn",a num); 
printf("Justify to the left "y 
printf("The number is :$-7dNn",a num); 
printf ("Cut it to 3 places 0» p 


printf("The number is :*3dWMn",a num); 

printf ("Zero fill to 7 places "); 

printf("The number is :$07dNn",a num); 
) 


As you can see, where we have tried to cut the number back to three places, it has not 
worked. The space has been expanded to allow the total value to be printed. 


In the case of floating point values you may want to specify the degree of precision 
with which you want them printed. For instance 955.2f will print the number to two 
places of decimals. 


If you want to print to two decimal places without setting the field size, you can do 
this by putting just the number of decimal places to be printed to the right of the 
decimal point. So %.3f will print the value to three decimal places with no setting for 
the field size. Have a look at Program 011. 


[ek Rap Np RE RAS es 


* 


* Program 011 
* Demonstration of decimal place 


x formatting with the printf () function * 
ee E EE AVI AQUA UQ KR a SL D 


* 


main() 
{ 
float num = 49.123456; 


printf ("The number is &f \n",num); 
printf ("The number is $5.3f \n",num); 
printf ("The number is $.3f \n",num); 
printf ("The number is $04.4f \n",num); 


) 


This will produce the following output: 


The number is 49.123455 
The number is 49,123 
Tne number is 49.123 
The number is 49.1235 
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You will notice that the printout is not accurate beyond the third decimal place. This is 
something which you should keep in mind when working with floating point numbers 
in C. Accuracy is not one of their greatest attributes. 


There are a number of other aspects to the printf() function for formatting output. They 
are not used so often as those given above. As such, they are left out of this section to 
try and keep it fairly simple. The whole of printf() under Turbo C is explained fully in 
the Reference Guide. Once you are confident in your basic usage of printf() sit down 
and read the relevant section in the Guide. 


The same advice will apply to all the standard functions discussed later. The aim of 
this book is to give you a basic introduction to programming in Turbo C. If you want 
to know all the ins and outs of the language, read the Reference Guide. 


scanf() 


The complementary function to printf() is the input function scanf(). This again is part 
of the standard library. It takes input from the standard input, this is usually the 
keyboard, and places that input in a designated address. 


Like printf() scanf() requires two arguments passed to it. The first is the control string 
which will consist of percent directives, informing it what type of input to accept. The 
second is a list of addresses telling it where to place the input. 


The form of the percent directives is the same as for printf(). 


To input an integer number the function would be used in the form: 


Scanf("$d", &a num); 


Ber variable. The & before a. num refers to address. A 
to read the & as being short for at. So what you are 
at has been expressed in the above statement is take the 
lace that value in the address associated with the variable 


Saying IS ‘store ata num'. Wh 


input of an integer value and p 
a num. 


LKR KK COO E KK KK AE OO RR EGER GGG 
* Program 012 


z F 
Demonstration of input using scanf () 
Antonne pae E E aa 


XCkCk kc kck k kck oko kk kok ok ko 


* 
/ 
main() 

f 


int a num = 0; 


printf("The value Of a 


.num is %d,\n" 
printf ("Please enter n us 


a num); 
grava tuel nne ny 


Scanf("%d", ga num); 


printf("\n\nThe new value is $&dWn", a num) ; 
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This is, of course, a very simple demo program. Study it and understand how scanf() is 
working. Try a few experiments of your own and see how you can develop the use of 
the function. 


Although versatile, there is a problem with scanf() which throws many programmers 
If you ask printf() to print a string: 


printf("$s", a string); 


the whole string will be printed right up to the terminating 0. Many programmers 
especially when they are starting, tend to think that scanf() will work the same witl 
inputted strings: it does not. 


First, scanf() ignores leading white space, that is spaces, tabs and newlines. It does nc 
start to read the string in until it comes across a character which is not white space 
Second, it terminates its read at the first white space character it comes across. 


This means that if the name Mike Richards is entered as s response to a scanf() inpt 
call, only Mike would be entered. Enter and run Program 013 and see how scanf( 
reacts to different string inputs. 


[III II CK I IKI IK KK IIA KIC KK X koX IKEA SEES 


* 


* Program 013 


* Demonstration of scanf() 
Kok KO Kk KK ck Ko Kok KK I KK ok C KK Kok CK OK OK RC IIIS ACH f 


* 


main () 
{ 
inte 
char string[30]; 
fore ( = Op X « NOG aee 0») 
{ 
printf ("\n%02d ; Enter a word or phrase .... "); 
scanf("%s", &string); 


printf ("\n\nThe accepted input was %s Xn", string); 
} 


printf ("\n\nRun Finished.\n"); 
) 
This program uses a for loop to take an input of strings. Do not worry about how it is 
working as we will be looking at that in depth later. All you need to note is how it 


reacts to different input. When I entered the phrase "Turbo C is the greatest", all that 
was printed out was "Turbo". 
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getchar() 


Another input function is getchar(). This function is defined in the file stdio.h. To use 
it, therefore, you must include the contents of that file in your program. This is done 
by making use of the preprocessor directive #include: 


#include <stdio.h> 


This will tell the compiler to include the system header file stdio.h. This file, in fact, 
includes a number of standard routines and definitions for input and output functions. 
| You will come across its use quite often. 


| The getchar() function when called waits for a key to be depressed and returns the value 
| of the key pressed. There is a problem here in that it appears to operate slightly 
differently on different systems. This appears to be a reflection of the version of 
| MSDOS you are using. On some systems it-will return a value the moment the key is 
| depressed. With other systems you will have to press the RETURN key. In these 
| latter cases this is taken as a second input. Enter and run Program 014 and see how 
j your system reacts. 


[Akkkkkkkkkkkkk ik kkk kk kkk kk kk kk kkk kkk k kk k kk k 


* Program 014 * 
| * Demonstration of getchar() * 


HR RR KK RK Kok kc kc Kok ck ok ok ke koe IO kok kk oko RK ok kkk / 


i | #include <stdio.h> 


main () 

{ 

n " int keypress = 0; 
^y R 

if MN char letter; 


while ( keypress != 32 ) 
{ 


keypress = getchar(); 
letter = keypress; 


printf("The letter was %c.\n", letter ) 


; 
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EE 


[IO SEI III II I II II III IIIA IS IIS III II ISIS ESS 


* Program 015 * 


* Demonstration of getche() x 
RII dl KE JOE JOE IOI IOI III JO IC KK ORO Koo Kok ISAS, | 


#include <stdio.h> 


main () 
{ 
int keypress = 0; 
char letter; 
while ( keypress != 32 ) 
{ 
keypress = getche(); 
letter = keypress; 
printf("The letter was ’e.\n", letter ); 
) 
) 
getch() 


The function getch() works very much like getche() which we looked at above. The 
difference is that it does not echo a character to the screen. This can be very useful, 
especially if you are using the key depression as a single rather than a character input. 
Consider the following code fragment: 


disk err message 0 


( 
printf("NnAn error has occurred on the diskNn"); 


printf ("read/write operation.The program will\n"); 
printf ("now abort. Please check your system\n"); 
printf ("before rerunning the program. \n"); 
printf ("\n\nPress any key to finish. Nn"); 


getch(); 


return; 


In this case a message will be printed and the system will then wait until a key is 
pressed. 

A word of warning about the portability of getch() and getche(). The Turbo C 
Reference Guide states that they are found on Unix Systems. That tends to be the only 
place you do find them. A number of MSDOS compilers do not support them. 


The above three functions all belong to a family of related functions based on the 
function getc(). This is one of the basic functions defined in Kernighan and Ritchie. 
When you are using them remember that they will wait for a key to be depressed. This 
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is not always what you want. Often you want to do one thing if a key has been 
depressed and something different if a key has not been depressed. 


kbhit() 


To meet the above requirement, Turbo C provides the function kbhit(). The prototype 


for this function is held in a header file called conio.h and this must be included in your 
code if you want to use the function. 


When invoked, if a key has been depressed kbhit() will return a non zero value. If there 


is no key read available it will return zero. In Program 016 I have used kbhit() and 
getch() to test for an abort situation. 


ASIDE EUER XOU XX A E CK E ee COR GC 


* Prog 016 p 
* Demonstration of kbhit() and getch() * 


SSDS LASTS LEA eene; 


finclude' <stdio.h> 


#include <conio.h> /* contains Prototype for kbhit() e CS 


main() 
( 
int i = 0; 


Printf("Press \"q\" to stop display\n"); 


while ( 1 ) /* This is Setting up anendless 


* loop because the while will always 
* be one therefore true, 


B 
printf ("%d Ue 3n 
i-i41; 


fe ( kbhit() ) /* Test for key depression, op 
Char let; 


let = getch(); /* Get value ofkey but 


* do not echo it to the 
* screen, 
K 


AR (C Sia cu 'q' ) exit (0); 


/* If q'was Pressed finish, E 
E 


| PEintf ("The key hit was 4c Nne 


,let); 


e printf("No key was hit \n"); 


This program uses what is known as an endless loop in which to test for the input of a 
key depression. So far, we have not looked at loops but we will do so in Chapter 9. 
For the time being note that in the form given the while command will result in the 
program looping forever. To escape from the loop I have set up a test condition. This 
tests if the value of the key pressed is equal to a lower case q. If it is, the exit 
command is used to leave the program, and thereby escape from the loop. The function 
kbhit() is used to detect if a key has, in fact, been depressed. A check is only made on 
the value of the key if one has been pressed. Otherwise, the program carries on and 
prints the information that no key was pressed. 


putchar() 


Just as getchar() is a special library function to allow you to have an input of a single 
character, there is also a special library function to allow the output of a single 
character. This is putchar(). Note once again that with Turbo C this will require you 
to have #include <stdio.h> at the start of your program. In fact, the inclusion of this 
file is so common in C programs, it is very unlikely that you will find a C program 
more than a few lines long without it. 


A couple of points with putchar(). It can only be used to print single characters at a 
time. Control characters like \n have to be passed to it in single inverted commas. 
Have a look at sampie Program 017 below. 


JEER ke ok kk Ck IR I KK DK KK OK SK RON Kk KK OK KK nk o koe ko RIG o 


* Program 017 x 
* Demonstration of putchar d 
dk ck koX Ko X kCOKOACKCKCKOkCA OK OK ee ee OO ROCK KK EK Ok ke 0x kk kk f. 


fiinclude <stdio.h> 


main() 
{ 


int num, scount; 


char buf[{]) = "Turbo C"; 
char ch; 
for ( num = 0; num <= strlen(buf); numt+) 
{ 
ch = buf[num]; 


for( scount = 0; scount <= num; 'scount*-* 
{ 

putchar (32); 

) 

putchar (ch); 

putchar('\n'); 


CC-0. Gurukul Kangri University Haridwar Collection. Digitized by S3 Foundation USA 


In this program we are using another form of loop which we demonstrate later in 
Chapter 9, the for loop. Do not bother now with how the loop is working, just look 
at the use of putchar(). In the inner loop we are using putchar() to put down spaces. It 
is passed the value 32 which is the ASCII value for a space. Once the number of 
spaces which are required for the offset have been produced by the loop, putchar() is 
again invoked. In this invocation, the variable ch is passed to it. This has been given 

the string ‘Turbo C. Finally, after this has been 


a value equal to one of the letters of 
printed, putchar() is passed the control character for a newline, this being passed inside 


single inverted commas. 


The printing of single characters is a fairly common activity in C programming and 
putchar() is somewhat more efficient at doing this than using the single character print 
facility in printf(). 


eer —! 


o EE 


THE C OPERATORS 


Operators are instructions, usually represented by single symbols, which when 
combined with values instruct the program to carry out some form of operation of the 
values. 


This concept may seem complicated, but it is quite simple. If I say "ADD TWO TO 
THREE", the values would be two and three. The operator in that statement is the 
instruction add. It may be represented in arithmetic form as: 


ZEE 


In this case the operator is "+". 


Table 7.1 Operator Descriptions 


Type of operator Description 
| Additive The addition and subtraction operators. + - . 
< 
| Multiplicative The operators which handle multiplication, division and modulo. 


S They are *, /, and 96. 


Relational The operators which test the relationship between two values. They 
i are greater than, less than, greater than or equal to, less than 
orequal to. >, <, >=, <=. 


Equality A special pair of relational operators which test for values being 
either equal or not equal. They are equals == and not equal I=, 
„Logical The operators which carry out ‘logical’ comparisons, ‘and’ and ‘or’, 
&& and ||. 
Yay These are operators which carry out an operation on a single value. ' 
They are the unary minus, - and the logical negation |. 
Incremental The operators which Increase or decrease a value by one unit, ++ 
and --. 
Bitwise These are a special set of operators which carry out functions on 


bytes at the bitlevel. They are covered in detail In Chapter 15. 
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of types of operator. Do not expect to memorize 


In the C language there are a number t 1 
Mes AU Il learn them is to use them. Read through and 


' them all now. The only way you wi 
become familiar with them. 


The Additive Operators 


Addition and subtraction are as one would expect. There are no nasty surprises here. 
Have a look at Program 018. 


JJ CK CIC RR IIR IR II OCIO OUO ROO ESE 


i * Program 018 * 


* Demonstration of additive operators 
Se RI II OI RR IO II IOI IOI TOIT II II III AK IK II f 


* 


| 

| include <stdio.h> 

| 

| /* Declaration of global integer variables. */ 
int f num, s num, t num, r num; 


main () 

{ 

b get num(); 

| add num(); 

: results (); 

P iy sub_num(); 
it results(); 

2M ) 


[RIK III II kkk k k kek I FO I TOI ITO IO FO TIT IO FOR ke ke k I k ke k 


The function get num takes the input of three * 
z integers and assigns it to the global variables.* 
À In this function a dummy getchar() is used to * 
dispose of the unwanted return left behind by x 
* 
/ 


* getchar. 

FRI ITO coke ok e e k ok ee e ok e kc e e ke ee IO III e e ke dk eek 

get num() 

( 
printf ("\nEnt 
AA ice sie Fo D Ex c 
f num = getchar() - '0'; ý 
getchar (); 
printf ("\nSecond Number : n); 
s num = getchar() - '0'; 
getchar(); 
printf("NnThird Number : "); 
t num = getchar() - 'o:. $ 
getchar (); i 
printf("NnThank you.\n\n") ; 
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eedem Ls 


[EE a RRR IR BE RCACAOOE EOORCAU CAUSIS CEN 


* The function add_num adds three numbers x 


* together and assigns the result to r num E 
UA oer ea AC I ROLE OR CEA aa 


add_num() 

{ 
printf ("\nAdding Numbers.\n"); 
r onum = £ numit Bim v t_num; 


) 


[RE ER Sce eS QE EN 


* The function sub num subtracts three numbers  * 


* assigning the result to r num. * 
RR A RAR ER ERGO ROO OR UR IG RA KDE C EDO ONDE 


sub num() 

{ : 
printf ("\nSubtracting Numbers. Nn"); 
TEnum = te A) ID t_num; 


} 


[en en a CE REUS REN 


* The function results() prints out the state of* 


* the variables and the result of the operation * 
ee eaten ek i NBS A OE mA EE EMI QA 


results () 

{ 
printf ("\nFirst number = $d ", f num); 
printf ("\nSecond number = $d ", s num); 
printf ("\nThird number = &d ", t num); 


printf ("\nThe result of the calculation was "); 
printf ("sd Nn", r num); 
) 


There is nothing particularly complicaied about this program. However, there are a few 
touches which are worth noting. 


First, we have proceduralised the program quite a bit. This means that we only have to 
write the printout sequence for the results once, even though we make use of it twice. 


As far as possible you should try to break your programs up into small, self-contained 
procedures. 


Note how each of the functions is commented, telling you what it is going to be doing. 
At the moment, these comments are fairly informal. As you work further into this 
tutorial you will find that the comments become more formal and more informative. 
The commenting of a program is important. If you ever have to go back to maintain a 
program months after you have written it, you will be grateful for good comments. 
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One practice which you will notice here is that use has been made of a dummy getchar() 
to remove the unwanted return left behind by getchar(). This is a very useful technique. 
Many of the input functions give problems with unwanted returns at the end of the 
input. The function scanf() is a particularly difficult one at times. Placing a getchar(), 
the return value of which is not assigned to anything, after the reading function can 
clean up the unwanted returns. 


In this program I have used the getchar() function to get the input of a number. The 
reason for this is that in this example only single digit numbers are required. The 
function getchar() will return a single character value. That value, though, is an ASCII 
character value. To use it as a number from 0 to 9, I have to strip off the difference 
between its ASCII value and the number it represents. This I have done by subtracting 
the value of the character '0' from the returned value. 


You will find techniques of this kind very useful when you want to limit the scope of 
input which may be given. 3 


The Multiplicative Operators 


In C there are three multiplicative operators. They are the multiplication operator, *, 
the division operator, /, and the modulo operator %. 
Multiplication works in the way familiar from normal arithmetic, From 4 * 5, that is 
four times five, you obtain the result 20. However, division can present a few 
surprises. 


If you are working in integers, and divide an integer by an integer, you will get an 
integer result. Any remainder that there might be is discarded. This is something 
which can be confusing if you are not expecting it 


Should you need to know what the remainder 


using the third of the multiplicative operators, the modulo operator. This also carries 
out a division. In this case, though, it only gives you the remainder as a result. 
Incidentally, the modulo Operator can only be applied to integer variables, 


of a division is this can be obtained by 


_ Program 019 gives a demonstration of the basic usage of the multiplicative operators. 


WISN IES SITS SS IOIERSODO GO GO ATTE ROG en 
* Program 019 


* 
.* Demonstration of multiplicative operator 


* 
FOO IOI 7 


S 
» 4include <stdio.h> 


e Global Variables, */ 


getnum(); 
multiply(); 
divide(); 
modulo(); 


JC ke kk kkk KK kk kk kk EKER KE KH WK KKK KKK EK KEK KK EK RAK AK 
* The function getnum() takes the input of two e 
* single digit numbers and assigns them to the e 
* global variables. * 


OK Ck OkCk XCk Kok X Ck E kCKCk KR RRR KK Ck hcKCK ChCKCKCKCKCKCKCKCK CK Ck KCK CK Ck k XCk kk f 


getnum() 

{ 
printf("\nEnter a single digit number - "); 
f num = getchar() > 1017, 
getchar(); 


printf("\nEnter a second number - "); 
s num = getchar() - '0'; 
getchar(); 


printf("\nThe numbers selected are "); 
printf ("%d and $d \n", f num, s num); 


[ERG ik e ck ehe ER ok i Hkc ke ok he CK Ck ok OAK ROAR SSID ARRAS a eS 


* The function multiply() carries out a multi- E 


* plication operation on the two numbers. * 
XOkckckock kk XCk X CK Ck Ok Ok OO Ok OK ee ee ee KK k OX koX kc k ko x xk f 


multiply() 
( 


r num - f num * s num; 


printf("\nThe multiply operator gives the "); 
printf("result $d Wn", r num); 


[RIED KK De KK GE De D Noe DK CD o e KU KK PA ctu anc D DE 


* The function divide() carries out a division * 


* operation on the two numbers. rs 
KOkCk Kok KO kok kOk II IOI KOk OI KCk KOk kCk KCK CK CK CK Ck K Ck Ck K X IKI / 


divide() 

( 
r num - f num / s num; 
printf("\nThe divide operator gives the "); 
printf("result %d \n", r num); 
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[Ck ek ke kc Sk ok ok ke eek kk ke RR CK IK CRACK IK IK KKK KK EEE n E 


* The modulo() function carries out the modulo 


* operation on the two numbers. 
Wkckckckckck ck k ck kckck ck k Kok k Ck k ck CK X k E KCKCkCKCk KCKCK CK CKCk CK Ck kk KOk kk kk kk / 


* 


* 


|i modulo () 
{ 


r num = f num $ s num; 

printf("\nThe modulo operator gives the "); 
E printf("result $d Wn", r num); 
HT ) 


Notice that use has again been made of the dummy getchar() call to cope with the 
problem caused by unwanted return key values. 


SN i Se iae, aes 


You should have a basic understanding of some aspects of C by now, so why not write 
a program on your own? One task you could try is write a short program to do the 
following: 


Take the input of two numbers. 
Divide the first number by the second number. ` 


Print the result with the remainder. 


One way of doing this is given in Answer 1 in Appendix 4. Before you look at it, try 
and work it out for yourself. Remember, the answer is just one way of doing it. There 
are a number of others. That is one of the enjoyable aspects of C, there are many 
different ways of using it to solve a problem. 


The Incremental Operators 


It is common when writing programs to increase or to decrease the value of a variable 
by one unit. In C you are provided with two operators to do this, they are the ++ and 
--. These are very useful operators, but should be with care. 


It is important to remember that it increases or decreases b 
some very nasty surprises. The incremental operators 
variable on which they are working. They adjust the am 
accordance with the type of variable. 


y one unit or you might get 
take into account the type of 
ount of the numeric change in 


With the normal numeric variables, they work as expected. If you have a variable 
f num and use the expression: 


Jf numt*; 


j the value of f num will be increased by one. For example, if f num was 1048 it will | 
be increased to 1049. The difference comes when the variable is a pointer. In the case 


of a pointer the numeric change will be equal to the size of the object in bytes to which 
the pointer is pointing. If you have a pointer of type integer, it is pointing to a two 
byte object. To increase the pointer to point to the next object in memory will require 
an increase of two. If you use the incremental operator on a pointer to type integer, the 
change will be two. So if our pointer p. fnum is pointing to a location -102 and we 
use the expression: 


p_fnumt++; 
the pointer will now point to location -100. 


The placement of the operator has an effect on how the operation is carried out. You 
can place the incrémental operators either before the operand, that is the value they are 
operating on, or after it. If you are using the operation in an expression this will make 
a difference. Note that: 


a = EEDI 
is not the same as: 


Gi c Jong 


The first expression says increase the value of b by one unit then assign that value to a. 
The second expression says assign’the value of b to a then increase b by one unit. You 
must keep this in mind at all times when working with the incremental operators inside 
expressions. 


Have a look at Program 020 which illustrates this. 


Met teh tt ee Ok kk KO Kok ck k k X k ck ck k Ok Kok ko k koX 


* Program 020 x 


* Demonstration of incremental operators * 
Ae OKOKI NOR Ae EE E E EAE aee kk kk e pce I E E e ATR SEIKO OR / 


main() 
( 
int i, r num, f num; 
f num = 1; 
r.num = f num++; 
printf("Nnr num = $d, f num = $d", r num, f num); 
f num = 1; 
r num = ++f num; 
printf("Nnr num = %d, f num = $d", r num, f num); 
) 
This produces the output: 
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2 
2 


1, f num 
2, f num 


r num 
r num 


In the first stage of this program one is assigned to f num then the value of f num is 
assigned to r num and f num is increased by one. The results of this are then printed 
out. In the second part one is assigned to f num, f num is then increased by one. 
Only then is the value of f num assigned to r num and the results printed out. 


It is surprising how often even quite experienced C programmers are confused by 
positioning of either -- or ++ and get a result they did not expect. This is so frequent 
that it calls into question the use of these operators. 


Saying: 

f_num++; 

is equivalent to saying: 
f num = f num + 1; 


although the latter is a great deal easier to read and understand. I am not saying that 
you should avoid using the ++ and -- operators. What I am saying is that you should 
use them with care and consider using the full assignment form rather than the 
incremental operators when you can. It may take more typing in, but it is far easier to 
read when you come to maintaining code. 


This brings us to the question of 'shorthand' forms in C. Very often you will find that 
C provides you with two ways of writing something: one which takes quite extensive 


The OP operator 


A common practice in programming is to do something on a variable and assign the 


result to the variable upon which the operation has been carried i 
t | out. Th 
a variable is probably the most common example: aene 


num = num + 2; 


In this case we have a variable num, which we have in ; i 
sort of action would be: creased in value by 2. A similar 


num = num * 9; 


Here we assign to num the old value of num times 9, 


— 
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This type of action is so common in programming that C has a special set of operators 
to handle this situation. The operator takes the form of the mathematical or bitwise 
operator iramediately followed by the equals sign. It says take the value on the left of 
the operator, carry out the operation indicated using the value on the right and store its 
result back in the variable on the left. Consider the following: 


num += 2;-* 
num *- 9; 


The OP form of the operators will work with all the mathematical operators and the 
bitwise operators with the exception of ~, the bitwise ones-complement, which is a 
unary operator. 


Using the OP operators can save you a great deal of typing. They also tend to make 
the programs rather more cryptic when you come to read them. Again, what I am 
saying here is use them by all means but take care that they do not impinge on the 
readability of the code. 


There are many C programmers around, usually from an assembler background, who 
think that short and cryptic code is good code. To an extent, in the early days of C, 
this was often the case. Operations like: 


numt++; 
num *= 3; 


would produce less code than: 


num + 1; 
num * 3; 


num 
num 


This is generally no longer the case. Turbo C, in common with most modern 
compilers, has quite an efficient optimization routine which will usually make a better 
job of code optimization than you can by selecting between the different ways of 
writing an expression. 


My advice is: try and write code which is in the form that is easiest to read. This is 
usually the least likely to have bugs in it, and the easiest to maintain. 


The additive, multiplicative and incremental operators explained in this chapter are the 
arithmetic operators within C. Four of the other operator sets: the relational, equality, 
logical and unary operators, are involved in truth testing. These are studied in Chapter 
8 when we look at the if statement. The final set of operators are the bitwise operators 
which are dealt with on their own in Chapter 15. 
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if ( condition ) action ; 


8 


TESTING RELATIONSHIPS 


The relational, equality and logical operators, together with the unary operators are all 
concerned with relational values. The testing of the relationship between values is a 


major element in most programming work. Take, for example, the following piece of 
Specification: 


Take input from keyboard. 

Assign input to variable key. in. 

Test if key. in is the letter y or the letter Y. 
If the test is positive go on to the next stage. 
Otherwise return to main menu. 


Here we have to compare the input from the keyboard and test it against two possible 
values, y and Y. This sort of procedure is fairly common in programs. 


True and False 


An important concept which you must understand is that of True and False. In the 
above specification we have a condition. D 


either y or Y? If it does, the condition is said 


In the C language, as with most but not all computer languages, the value zero is used 


to represent false. As you can only have one of two results, either Something is true or 
it is false, any other value than zero must be regarded as true. So if a test is constructed 
to test if the input from the keyboard 


i p is either y or Y, it will retum a non-zero value 
when the input is y or Y and a zero value when it is not, 


The if Command 


The if command carries out a test of a condition. If the condition is true, then it carries 
Out an action specified in the 


statement. If it is not, the action is ignored. The basic 
form of the command is: 


If ( condition ) 


( 
actionl ; 
action2 ; 
action3 ; 


actionn ; 


) 


The structure of an if statement is such that if the condition is true an action is carried 
out. If not, control moves onto the next statement. This is shown in Figure 8.1. 


ACTION 


Figure 8.1 
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The Equality Operators 


The simplest type of test is to test if something is equal to, or not equal to, something 
else. Tests of this kind are done using the equality operators, == and !=, 


The == operator tests if something is equal to something else. So: 


is saying is a equal to b? 


H The != operator tests if something is not equal to something else. So : 


is saying is a not equal to b? 


Program 021 gives a simple demonstration of the equality test on the input from the 
keyboard. 


[RRO C CMM 


b * Program 021 
* 


* 
Demonstration using equality operators to test* 
* input from the keyboard * 


ESE SS EL NET SATS ET AA GERE OI Re CR 


/ $include <stdio.h> 


M. main() 


j ( 
ji 
| UN $ char letter; 


while ( 1 ) 
( 


printf("\nEnter a letter 
d letter - getche(); 
|J if ( letter -- ty") 
"P ( 


7) p 


printf("XnLetter was y, now exiting. "); 
exit (0); i 


if ( letter != ty! ) 


printf ("\nLetter Was not y,"); 
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ET 
Tz 


In this program a character is entered from the keyboard and the value of that character 
is assigned to the character variable letter. This is done inside a while loop. Two tests 
are now carried out on the variable letter. If it is equal to y a message is printed and the 
program is exited, thereby escaping the endless loop. The second test checks if the 
letter was not equal to y and then the loop continues. 


The else command 


If you think about Program 021, if the first test is false, the second must be true. The 
second test is immaterial. We could have just had one test. Sometimes though, you 
need to carry out an action if the test is true, and another if it is false. This is where 
the else command comes into use. 


S CKCKCOK CK Ck kk I Ok KK Kk kk e k k k k CK Kk CURRO k k IK k KK UU 
SES 5) ^ 
* Program 022 * 


* Demonstration of else * 


XCkckokckckOkCk kckckCk CK k KCk CK KCKCk CK K KCK CK k Ck CK KOkCKCk kck ck k kck ck Ck KOk Ck ck ck ko k / 


main() 
( 
char letter; 


while ( 1 ) 
( 
printf("\nPress a key "); 
letter = getche(); 
if ( letter == 'y' ) 
{ 
printf("\nThe letter was y. "); 
) 
else 
printf("\nLetter was not y.")? 
if ( letter -- 'q' ) exit (0); 


) 


In Program 022 one of two actions is carried out depending on the result of the 
condition in the if statement, The basic structure of an if..else statement is that if the 
condition is true, one action is carried out, if it is not, another is carried out (see Figure 
8.2). 
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START 


ACTION 


ACTION 


Figure 8.2 


The relational Operators 


hand side of the operator 
The relational operators are: ted by the operator, then the test is regarded 5 true. 


> is greater than. 
< is less than. 


>= is greater than or equal to, 
<= is less than or equal to, 


P 


'ukul Kangri University Haridwar Collection. Digitized by S3 Foundation USA 


ipio 
SM. . 


You can see how these are used in Program 023. 


[RRR RRR de e e de He de KEKE KER KKK KE KER EEK MARE KEENE 


* Program 023 * 
* A demonstration of the relational operators. A x 
* This routine converts lower case letters * 
* to upper case. * 


ee XO OK KO Ok KC ORC OX ee ee ee e 0 0 f 


f#finclude <stdio.h> 


/* function prototype */ 
char make_upper( char let ); 


main () 


{ 


char ch; 

while(1) 

( : 
printf("\nEnter any character DU" 
ch = getchar(); 


getchar(); 


ch = make upper (ch); 


printf("\nThe character was $*c " ch); 
if ( ch == 'Q' ) exit (0); 


char make_upper( char let ) 


{ 


if ( let < 'a' ) return (let); 
if ( let > 'z' ) return (let); 
return ( ( let - sat ) + 'A'); 


) 


This program takes the input of characters inside an endless loop. We look at the 
workings of such loops in Chapter 9. The inputted character is passed as an argument 
to the function make. upper(). As this function is not returning the default type int we 
have specifically prototyped it at the start of the program. In the function 
make. upper() two tests are carried out to check that the character is a lower case letter. 
If it is not, then it is returned unchanged. If it is, the value ‘a’ is subtracted from it and 
the value 'A' added. Due to the arrangement of the ASCII code this has the effect of 
changing the value to that of an upper case letter. This is then returned. 
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In fact, this is all rather a waste of time as Turbo C has a function in its standard | 
library which will do this for you. That is toupper(). It is good practice, though, to 
write your own version of functions like this. How about writing one which will 
convert upper case to lower? An example of such a function is given 1n Answer 2 in 


Appendix 4. 


The Logical Operators 


Quite often you need to have a command carried out if one or another condition is true, 
or sometimes only if all conditions of a set of conditions are true. You can, of course, 
cover this by using complicated if structures. Consider the example of Program 024. 


J| ORC ok ke ok koe kk koe Oe de de ok Ck e e Ae he he e Ok CC ok e ok e e 
* Program 024 * 
* Complicated if structures * 


A kk e ke c kc ke ke ke ke ke ok ke ke e ke oe ke ek kkk kikk IOI kk TOR e kk e ke e ICI / 


#include <stdio.h> 


main() 
{ 
char f let s let; 


printf("\nEnter a character ; "p 
f let = getchar(); 

getchar(); 

printf("\nEnter another B "5 
S let = getchar();. 

getchar(); 


if ( f let >= 'Q' ) | 
{ | 
if ( f let <= '9: ) 


printf("First Character is a 


if ( s let >= 10! ) 
{ 


number. \n") + | 


if ( s let <= 191 ) 


) printf ("Second character is a number. Wn")! 


D 


S Vnd opening this book at random and seeing this example ` 
nditions in truth nee S UPPOTS two logical operators which allo" 
The operators are; 


The AND operator && 
and: 
The OR operator Il 
If you look at the following: 
if( (x«5 && y>5) || (x»10 && y<10))  ....- 


what is being said here is: 


if x is less than 5 and y is greater than five carry out the action, or alternatively if x is 
greater than 10 and y is less than 10 carry out the action. 


If we replace the multiple if statements in the above program with if statements using 
&& we can have a much shorter program. Study Program 025. 


[DO III IO IOI I IOI IO RIOR I TOI II IIR IIIS IRIE ESS 


* Program 025 x 
* Demo Using if with && so that two conditions  * 
* are required to be true before action is x 
* taken. ex 


Kok KK CK Kk CK CC KC TKI TK IIIT ISI IIIA KK KK ok koX oko f 


#include «staio.h» 


main() 
( 
int f let, s let; 


printf("Enter a character yg 

f let-getchar(); 

getchar(); 

printf("Enter a second character "); 
s let-getchar(); 

getchar (); 


if(f let >= 'O' && f let <= 910) 
printf("First character is a number\n\n"); 


if(s let >= 'O' && s let <= '9') 
printf("Second character is a number\n\n"); 


Having entered the above and found out how it works, try altering parts of it and see 
what effect this has. You should now try the following. Write a short program making 
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use of the Il operator to accept as a true input either upper or lower case y withoy 
having to do a case conversion. 


Such a routine can be very useful once you have written it. It is quite common in 
programs to require a Yes or No input to be given with a single key entry of the Y or | 
N keys. The problem is that you must allow for it being given in either upper or 
lower case. To convert all input to upper case or vice versa then do the test takes much 
more coding and run time code than a test which allows for both options. 


The Unary Operators 


These are operators which operate on a single variable or expression. There are two in 
the C language, they are: 


The NOT operator ! 
The NEGATION operator 


Let us consider the NOT operator first. A comm 


on type of test in programming is to 
see if a variable has a value of zero. Such a test c 


ould be written as: 


if(f num == 0) 


As we explained above, the value 0 is false in the true/false testing. Therefore, if 
num is equal to 0 in the abow. 


j e value the result returned is a value other than 0. It we 
had written: 


if(f num)... 


SUE LIS. maya) 5 5p 


it is the same as writing: 


iff num == 9)... 


This is because when f num į 
NOT operator into true, Just 


h: 


Š equal to 0 false is returned but this is inverted by the 
.. would return true but the not 


as when f. num is equal to an 
inv al f. num 
Operator inverts this into PLA peanother than O 


ate == 0) more briefly, It is more difficult 
"y Programmers prefer to use (f. num == 0) rather than 


the shorter (!£num). With modern optimizing compilers like Turbo C there is little or 
no advantage in using the NOT operator rather than the test for equal to zero. The 
compiler will normally compile both to the same code. 


The other unary operator is negation. This is a - sign placed in front of any variable or 
expression and has the effect of reversing the sign of that variable or expression. 


For example, if the value of (x-y) is positive, then -(x-y) will be negative. 
The ? and : operators 


One of the most common types of selection using the if else structured test is to return 
one of two values depending on the iruth of a condition. Consider the following code 
fraginent: 


if ( ch >= a Mes ch <= 124) 
dduct = 32; 


else 
dduct = O0; 


In this fragment a test is made to find out if the character ch is a lower case letter. If it 
is, the integer variable dduct is then given the value 32, if not, it is given the value 0. 


The important point about this is that the test can only return one of two results 
depending on whether it is true or false. Such tests are so frequent in programming that 
C has two special operators to deal with it; they provide a shorthand way of expressing 
such situations. The two operators are ? and : which are used in the manner: 


«allocation» = (test) ? «result if true» : «result if false»; 
So the above example can be rewritten as: 
dduct = ( ch >= 'a' && ch <= 'z' ) 2 S34 98 OP 


These structures can be used to combine the test within another expression. For 
instance, the test for printing the largest of two numbers could be combined with the 
print command as: 


printf( "$d",(numl >= num2) ?numl:num2) ; 


This is illustrated in Program 026. 
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k X*ckokck kc k k KK KKK 
J[ CK Ck kk kk kk kc IOI COR IOI TI IK IK 


* 


* Program 026 


* 
i 4 * Demonstration of ? and : operators 


x KKK KKK 
Ok ck KCk ck ee Ok Ck KK ko ee ee ee x ko kx y 


main() 

ji ( 
iL int numl, num2; 
I 
y 
| 
Iu printf("Enter two numbers "); 
I 

scanf ("td%d", &num1, &num2) ; 

printf ("%d\n", (num] > num2 ) ? numl : num2 ); 


| printf("\nThe largest number is : "); 
I 
| 


Although the ? and : operators can be very useful, especially when writing code macros, 
they should be used with care. Alhough they take less typing and produce less code 


| 
| than the if else tests they are always less easy to read. This can result in difficulty in 
| debugging and maintaining code. 


As a basic rule it is advisable not to use the ?: 


macros unless a speed or code size advan 
the situation where they are used. 


operators outside the definition of code 
tage can be demonstrated which is important in 


GOING ROUND IN 
CIRCLES 


More often than not, in a program you will want to do something a number of times. 
In fact, we have already done so in some of the examples , although use of the while 
statement has not been explained. 


The method used to carry something out a number of times is looping. There are three 
looping statements in C. They are: 


while 
do-while 


for 


The while Loop 
With the while loop the syntax is: 


while(condition) 
action; 


While the condition is true, the action will be repeated. Multiply actions can be 
included by using curly brackets in the form: 


while(condition) 
{ 
action]; 
action2; 
action3; 


[ 


The important point to remember about the while statement is that the condition is 
tested at the start and the actions only carried out if the condition is true (see Figure 


9.1). 
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START 


ACTION 


do-while Loop 


s is the do-while Statement. This has the form: 


Whilst some compilers will accept a do statement in the above form, many insist that 
curly brackets are used even when there is only one action. As this also makes the do- 
while statement more readable they should always be used. So the form should be: 


do 

( 
action; 
) 


while(condition); 


Here the test is made at the end and a do-while loop will always be performed at least 
once before the test is made ( see Figure 9.2). This is not the case with a while loop. 


ACTION 


Figure 9.2 The do-while loop 
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Have a look at Programs 027 and 027. 


x ACKCK RO koX 
[RK KKK kk kk KKK AC KCk ck KCkCK KR KKK KK KKK KR KX 


* Program 027 : 
* Demo of while loop 


kx f. 
KKK ck k kck XCk X CX X CK k RA KR CXCk XCk KKK KK KK OK OX RK KKK KK X X koX 


include <stdio.h> 


main () 

{ 
char ch; 
int f_num; 


f num = 0; 


printf("Enter a character "); 
ch=getchar(); 
getchar(); 


while(ch != 'q') 

{ 
printf("%d\nEnter a character 
ch=getchar(); 
getchar(); 


",**f num); 


) 


SSSR SELES AE SX E SEEK KDKOR CK KCRCK KKE K KKK CC 
* Program 027a 
* Demo of do-while loop * 


EI IISEE SES ETE TT ee 


* 


finclude <stdio.h> 


main () 

{ 

IE char ch; 
n int f num; 


f num = 0; 


printf("Enter a character "); 
ch=getchar(); 
getchar(); 


a do 

IM. { 

: printf ("%d\nEnter a character "ttf num); 
ch-getchar(); n 
getchar(); 


while(ch t= 'q'); 
) 


anything whilst the second one will print up the value 1 and ask you to enter a 
character. 


Another fact you should notice here is the inclusion of the incremental operator upon 
f num inside the printf statement. This is a shorthand method of writing: 


**f num; 


printf£("td\nEnter a character ",f num); 


and in this case does produce less object code. 


The for Loop 


The for loop has the following form: 
for ( initialization; condition; change) action ; 
multiply actions may be included by containing them inside curly brackets: 


for ( initialization; condition; change) 
( 
action]; 
action2; 
action3; 


) 
Program 028 is a simple counting program which demonstrates the use of the for loop. 


HERE AE UA DADE Ba DEOR UScUE DDR DR A OU UD EE 


* 


* Program 028 


* Demonstration of a for loop 
deck ckok KK Ck KK CO IOI KK IO IC f 


* 


kk kk Ok OO KO k k IK OK I OK GC IE 


main() 
( 
int f num; 


for ' f num = O ; f num < 10 ; f numt* ) 
( 
printf ( 
) 


"The value of f num is now $dNn",f num); 


) 


Try this one out and then try playing around with it. What happens if you alter the 
change section of the for statement from f. num-- to ++f_num, or if you alter the 


initialization value? 
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Try a few different things and see what tne result 1s. 


CHANGE 


ACTION 


Figure 9.3 The for loop 


Getting Out of Loops 


Normally, a loop will execute until the exit condition is met. In the case above, it will 
execute until the value of f num is greater than 


or equal to 10. Sometimes you will 
Want to get out of a loop before such a condition is met, 
This can be achieved by usi 
used within a loop, an 


break statement with all three types of loop. Each of these loops should operate 20 
times. However, if either q or Q is entered you will jump out of the loop. Try them 


and see. 
break 
while() 
{ 
c = getchar OLE 
if (c = = 'q') break; 
putchar (c); 
} 
printf ("hoop ended NE 
Figure 9.4 The break statement 


JEEE EE Hn mE ROADS OA RC a at a 
* 


* Program 029 


* Break from while loop 
Wk OR Kk kck KOk XCK Ck X Ck CK CK kk kk kkk 


* 


KOkOk OK KC XC KK OTR X KC XX f 


#include <stdio.h> 


main () 

{ 
int f num; 
char ch; 


printf("This is the start of the loop "); 


printf("f num is set to zero.NnNn") ; 


f num = 0; 


while ( f num « 20 ) 
{ 


printf (“$d Enter a character ",f num); 


ch=getchar (); 
getchar(); 


if ( ch == 'q' |l ch == 'Q') 
break; 
| f numit; 


printf ("The end value for f num is %d\n\n", f_num) ; 
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* Program 029a 
* Break from do while loop 


E kk oko 
[RRR Ck KCKCkc Kk Ck KR A X CK k KO KCk KCKCK Ck k X k KCk k Kk Kk AOK X X CK Xo 


* 


* 


DL ORUSORORQAUA ck oe koe II OO KO ok o ee kk eK oko K k e / 


$include <stdio.h> 


main() 

( 
int f num; 
char ch; 


printf("This is the start of the loop "); 


printf("f num is 
f num = 0; 
do 


{ 7 


printf("$d Enter a character "' 
ch=getchar(); 


getchar(); 
lif ( ch == 'q' || ch == 'Q') 
break; 
f_num++; 
) while ( f num « 20 ); 


Printf("The end value fór f num is 
) 
JJ RO KK RO Ck ARERR AKER KE KK k 


* Program 029b 
* Break from for loop 


BUD esr ooo ooo TT onines 


#include <stdio.h> 


main() 

{ 
int f num; 
char ch; 


printf("This is the star 
Printf("f num is setgto 


for ( f num = 0 i f num < 20 
i E 


à Printf("$d Enter 
ch-getchar(); 
getchar(); 


if 


a character ' 


( ch == 


'q' || 
break; 


" 


set to zero.\n\n"); 


',f num); 


%d\n\n",£ num); 


KKK Kk kk kk kk kk kk e k 


* 


* 


/ 


t of the loop "); 
zero.\n\n") ; 


i £_num++) 


',f num); 


Jumping to Start of Loop 


Sometimes, if a certain condition is met within a loop you will not want to go on with 
the rest of the operations within the loop, but ai the same time will not want to 
abandon the loop. This can be achieved using the continue keyword. Have a look at 
Program 030. e 


J[ CK eK Ke KR e Sk ke KK Kk E Sk Kk Kk ok Ke skr or oic KE EA 


* Program 030 x 


* Use of continue e 


deokck Ck XX KOKCKCKCKOKOKCK OK CK XOKCk Kk Ck Ck KCk Ck X Ck A X KCk Ck Ck Ck CK CkCKCKOk X X kok k x / 


#include <stdio.h> 


int f num; 


char ch; 


main() 

( 
printf("Now setting up loop with f num = O\n\n"); 
f num - 0; 


while(f num « 26) 
( 


printf("Enter a letter WB 
ch = getchar(); 

getchar(); 

if(ch < 'A' || ch > 'z') 


continue; 
printf("The ASCII code for the letter $c is %d\n",ch,ch); 


if( ch == 'q') 
break; 


) 


Here we are taking the input of a single letter and printing the ASCII value of the 
letter. We do not want the ASCII value printed if it is not a letter, therefore in the if 
statement we test for a none letter and if the test is true the continue statement jumps 


the operation back to the start of the loop. 


Incidentally, this program is not correct. It works because the letters are in sequence. 
Unfortunately, there is a small group of none letters with ASCII values 91 to 96 in the 
middle which break up the sequence. This program does not test for them. Try 
amending the program to exclude this small group. 


& 
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for (i = £f; i < 100; i++) 
{ 
c = getchar (); 
aie (ie ce SY) 
continue; 
i mem [++q] = c; 
| : 


) 


Figure 9.5 Using continue 


Something which must be kept in mind with the continue statement is that the jump 
i will be made to the test in both while and do, while loops, but to the change in a for 
loop. This is important when making use of the continue statement. 


Endless Loops 


There are times when you want to continue without end, or at least without the loop 
| Ji test producing an end. If an empty test is given to a loop condition, C will always 


treat itas true. Consider the following examples: 
while () 
| ( 
let = getch; 
de (o ( see >= VA" ge jet cans ) i 


(et >= tat ca let «2'2!)) 
putchar(let); 


EEU else 
"T | if ( let == 27 ) break; 
-— d ) 
n : 
E A SAER This loop will continue to take input and put any letters to the Screen until the Escape 
Ti 1. Jb bm key is pressed. In a for loop the empty conditio 


n takes the following form: 
for ( ; 
{ 


statements; 


7 >) 


while (TRUE) 
or 


for(;TRUE;) 
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Although this will take fractionally more code, the benefit to debugging and 
maintenance of code is well worth it. 


Problems with Floats 


There is a problem which arises when using floats in relational tests. It usually comes 
to light when working with loops. If you consider how computers deal with numbers 
it soon becomes clear that they do not have an accurate method of representing certain 
floating point numbers. One aspect of this is that there is no way of exactly 
representing the value 0.1 in binary, which is the way computers deal with numbers. 


Study Program 030a. 

[RIO TO TO IO IOI II IIIT III IR FARIA III EEE ES 
* Program 030a * 
* Problems with floats in loops * 


dock Kk FI OI III I CK SOI II II III IIA IIIA III IK f 


#include <stdio.h> 


main() 

{ 
float num; 
char let; 


num = 0; 
while ( num != 1.3 ) 


{ 


printf("Press a key "); 


let = getch(); 

printf ("%f, &c\n",num, let); 
if ( let == 'q' ) break; 
num = num + 0.1; 


) 


If you enter and run this program, it requires you to press a key before it prints out the 
current value of num and let. What you expect is that it will stop when num gets to 
1.3. You will find it will not, and that you will have to press 'q' to escape. Look at 
the test. It reads, ' while num is not equal to 1.3 do’. This means that when num gets 
to 1.3 it should stop. Unfortunately, it will not. The reason for this is that the binary 
system used within the computer cannot exactly represent 1.3, therefore the chances of 
an exact match being made are very slim. Having said this, due to a certain degree of 
randomness (which exists in such representations) you may find on some systems, in 
some circumstances, an exact match will be made. 

The way around problems of this type is not to test equality or inequality on floats. If 
you are using floats you should not use == or !=; that is a basic rule, The rule is so 


8] 
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basic that there have been suggestions that the standards should be written to make it 
impossible to use these operators with floats. Fortunately, this has not been done. 
There are a few (and that is very few) times when using the equality and inequality 
operators on a float is useful, especially when you want to test the accuracy of your 
system's binary representation of floats. 


Returning to the main point, if you need to use floats in a comparative test, do so 
using the less than and greater than tests. In this way you can test within a degree of 
accuracy which you desire. For instance, if you want to check if something is equal to 
2.35 to a degree of 0.001 you could write: 


Dira nume» 27349) «es num « 2.351 ) ) 


Here we are testing that a number is greater than 2.349 and that it is less than 2.351. If 


this is true it means that the number is equal to the value we seek within the degree of 
| error we are prepared to allow. 


In Program 030a our intention was to stop the loop when num got to 1.3. We did not 
i f want the loop to be performed when num was 1.3 so our interest was in those values of 
| 

| 


num below 1.3. It is, therefore, possible to write the program as shown in Program 
30b and obtain the required result. 


* Many of the bugs created in C programs are caused by the unexpected behaviour of 
1 floats in relational tests. Treat them with care, and if possible, avoid using them in 
relational tests. 


[RIOR III XXXIX CRX XC CK CA ACC XO OX XX KK 


* Program 30b 
* Problems with floats in loops * 


POCKCCKOCOOK OOIOOODIOKOCCIOCR JOE I E E OO ROCK ORO III I tO / 


* 


Wl i #include <stdio.h> 


l main () 
PE ( 


float num; 


char let; 
num = 0; 
è j while ( num « 1.3 ) 
ae! Be ee AA a key :"); 


let = getch(); 

printf ("s£, %c\n",num, let); 
if ( let == ‘q' ) break; 
num = num + 0.1; 


} 


Enter and run it, noting the difference, 
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GETTING THE MATHS 
RIGHT 


One of the problems with mathematics is knowing how an expression will be 
interpreted. Thus, if we have an expression: 


24*4*6 


we could first add two to four to give six, then multiply by six to give thirty-six. 
Alternatively, you could multiply four by six to give twenty-four and then add two to 


give twenty-six. 


rpretation of expressions. The rule is that 


Mathematics has very strict rules for the inte 
the correct answer is twenty-six. 


you do multiplication first, and then addition, so 


With computer programming languages we have the same problem. If we write a 
how it will be interpreted. The C language has a set of 


statement we must be certain 
rules for the interpretation of expressions. These rules cover all the C operators, but 
we are only concerned with the mathematical operators at this stage. 


rators, that is multiply, divide, modulo, add and 
The members of each group have the same level 
higher priority over the other. The first group 


The rule is that the mathematical ope: 
subtract, are contained in two groups. 
of priority. However, one group has 
consists of: 
multiply y 
divide / 
modulo . % 


The second consists of: 


add + 
subtract 
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Within any statement, operations of a higher priority are undertaken before those q 
lower priority, but where there are a number of operations of equal value they a 
interpreted from left to right. So, in the following case: 


ronum = 3 * 4 + 8/2; 


à three will be multiplied by four to give twelve, then eight will be divided by twou 

| give four. Finally, twelve will be added to four to give sixteen, that answer bein 
. assigned to r num. It might be that what you actually want is three times the sum of 

i four plus eight, the total divided by two. You can, however, force the compiler to cam 

j out certain operations in precedence to others by enclosing them in brackets. Anythin 

in brackets will be evaluated first. So to get the required result we would have to write 


PUM e a E *28 y / 2; 


The correct use of brackets can be important. First, it forces the compiler to undertake 
the calculation in a specific way. More significantly though, it makes it much clearet 


what is happening. This is especially true when you have operators of equi 
precedence. Consider the following: 


rnum- 15 / 3 $ 2; 
This is far clearer if it is written as: 
numus (15/3) $ 2; 


even though this will make no differenc 
expression left to right anyway; 
precaution in case you have to 


, to force the order of the calculation eve 
reason for doing so. 


Incidentally, when you have brackets inside brackets as in: 


INN — AS Go (ey S (s num % 2) + 5) % 6); 
the innermost set of brackets 


will be evaluated first. 
the value 4 and s num the val 


So in this case, if we give f num | 
ue 6 the calculation wil 


l be as follows: i 


Ona MORS G S Ah S a - cj 


13. * ((4 — 0 t*UsyES 6) 


because the first operation carried out is the innermost in thi 6% 
2 which is 0. We now get: ; Set of brackets, in this case 


dents Au sy 


because again the innermost brackets is calculatea, and in this case it was 4 - 0€ 5 
which is 9. Now the last set of brackets is dealt with: 


ig) e = 

because 9 % 6 is 3, and we get the final result which is: 

39 

Be careful about the use of the operators. Although with arithmetic operators the order 


of operation is always from left to right, eg 9 / 3 means divide 9 by 3, with some 
operators the order is from right to left. 


(x + (2) (x2) S0) e 1 792) 


5th 


The innermost bracket set is dealt with first. Where two sets are at the same 
depth the leftmost will be dealt with first. 


Figure 10.1 Order of precedence of brackets 


BENE cR 


91 


CC-0. Gurukul Kangri University Haridwa 


= 


ARRAYS 


So far, we have looked at variables as single entities. A special type of variable is an 
array. 


An array is a collection of variables which are all of the same type and are organized 
sequentially and accessed under a single name. Let us consider an illustration. We 


could have a series of ten integer numbers. These could be declared as ten integer 
variables so we would have: 


int first num, 
secon num, 
third num, 
forth num, 
fifth num, 
sixth num, 
Seven num, 
eigth num, 
ninth num, 
tenth num; 


Provided we are using all these singularly, 


there would be no problem, but if we are | 
using them in block form, problems would 


arise. If we need to use the sixth element. | 
in the block we first have to go through a 


1 long procedure to find the name of thal 
element. We can, nowever, declare ten integer variables as an array; 


int numbers([10]; 


numbers [0] 
numbers[1] 
numbers [2] 
numbers(3] 
numbers [4] 
numbers[5] 

| numbers(6] 

numbers(7] š 

numbers[8] 

= numbers(9] 


Lui nb) Du — 


Note that although there are 10 elements to the array they are numbered from 0 to 9. 


Each element in an array can be addressed by using the offset to that element in the 
array. So if we wanted to put the value f_num into the sixth element in an array called 
numbers we could with: 


.numbers[(5)] = f num; 


ARRAY OF 7 ELEMENTS 


OFFSET 3 
OFFSET 5 


Figure 11.1 


More useful is the fact that the offset can be represented by a variable to which the 
value 5 could be assigned. In such a case you would have: 


index = 5; 


numbers[index] = f num; 


Have a look at Program 031 which uses two for loops and an array to take the input of ter 
numbers and print them in reverse order. 


DERE REN RADAR UAR o RR MUR QE CM MME 


* 


* Program 031 
* demonstration of array of integers * 


pe ic ac ERU ROCA D SCR UERITAS NDA aD A ED DM 


#include <stdio.h> 
int numbers(10]; 
main () 

{ 


get num(); 
rev num(); 
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9 | 
| 
get num() 
{ 
int index; 
for ( index = 0; index < 10; index ++ ) 
i . 
printf ("%t-2d Enter number :", index); 


scanf ("%d", numbers [index)]) ; 
getchar(); 
) 


printf("End of input.\n\n"); 


rev num() 
( 
int index; 


for ( index - 9; index »- 0; 
{ 
printf ("%2a, ",numbers[index]); 


) 


index -- ) 


printf("\n\nEnd of output.\n"); 
} 


Let us analyse what we are doing in this program. First, we have declared an array of | 


integers with ten elements under the name numbers. The declaration is global, that is, 
known to all functions within the program. 


Next we have the main 


© function. This calls two functions up, 
rev num(). 


get num() and 


The function Bet. num() takes the input of the numbers to the array. In this function 


we declare a local integer variable, that is one known only to this function, called 
index. This will be used for the offset of the members of the. array. 


eee ben Wo 


inputted being assigned to the 
d by the value of index, Here again we have used 
anted carriage return, 


—— 


Finally, in this function we have a message stating that you are at the end of the input. 


Next we go on to the function rev num. Again, index is declared 'as a local variable. 
The for loop is used again but this time it is a decreasing loop with thé change being 
the decremental operator —. Two points to note here are that the value to which index 
is initialized is 9, not ten, even though there are ten elements in the array. Remember 
the array elements start at 9 not 1. Also, as the last element in the array (if we do a 
count down) is 0 the test is greater than, or equal, to zero. 


In the printf() function again the numbers outputted have been formatted. This time 
though, they have been right justified. Note also that there is no line feed in the 
function argument so all the results are printed out on one line. For this reason we 
have to start the final message with two line feeds to get spacing correct. 


Now look at Program 032 using an array of integers. This takes the input of 10 values 
then sorts thern into descending order. 


[3k A OIC RIOR IIE IA EIR IA ISA IAS EIS IA SSIS TSS SG 


* Program 032 e 
* 2nd demonstration of array of intergers * 


seo oe ea Kc ok KK Be i ER IC DE IR TT RS 


$include <stdio.h> 
int numbers(10]; 


main () 
{ 
get_num(); 
printf ("The unsorted array.Mn"); 
print array(); 
sort num(); 
printf("The sorted array.\n"); 


print array(); 


get num() 
{ 


int index; 


for ( index = 0; index < 10; index ++ ) 
{ 

printf ("%-2d Enter number :",index); 
scanf ("%d", &numbers [index]) ; 

getchar(); 

) 
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printf("End of input.\n\n"); 
) 


print array() 
{ 
int index; 


printf("The array is as follows SNR 


for ( index - 0; index « 10; 
( 
printf("Element $-2d 
3 


index, ++ ) 


*5d \n", index, numbers[index]); 


sort num() 


{ 
int index, hold, flag; 
flag=0; 
while (flag==0) 
{ 
flag=1; 
for(index = 


0; index < 9; index ++) 
{ 


if( numbers [index] 


( 


« numbers [index+1]) 


hold = numbers [index]; 


numbers [index] = numbers [index+1); ý 


numbers [index+1]=hold; 
flag=0; 


lore readable, ; 


are the same in operation. 


——ÓM— 


Array Class 


Arrays, like variables, can be auto or static. When an array is within a function it mus: 
be specifically declared static if you want to initialize it 


Array Initialization 


Like variables, arrays can be initialized when declared, although this facility is not 
present in all compilers. 


To initialize an array the general form would be: 


‘int numbers[4] = { 1, 2,.3, 4 Me 


where the values to be allocated to the array are held in a set of curly brackets. These 
values will be read into the array in order from left to right, starting from offset 0. 


With Turbo C and some other compilers, if the size of the array is not specifed, then 
the compiler will construct an array of sufficient size to take the values specified. In 
the following example: 


int numbers{] = ( 1, 2, S dy Bo 6 N 

will set up an array of 6 elements. 

Note that if an array to be initialized is not global, then it must be of class static. 

Look at Programs 033 and 034. The first is a very simple demonstration of initializing 
an array: 

inasa e e es eis 


* 


* Program 033 


* Demo of an initialized array. 
* Demo of an xk Du EN A 


* 


int numbers[5] = ( 1, 2o Sy Go 9 XP 


main() 
( 


int test; 


test-0; 
“Mine ( cess < 9» 


printf edd nubes SU 
testtt; 


) 


The second shows the initialization of an array within a function. It is basically the 
same program as 033 but the array has been declared within the function. 
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[RR ERK EEK KIRKE ke ke e e Sk KK KKK KKK KK KK RR RE KEK CK OK OX OK RE KKK 
* 
* Program 034 
* Demo of an initialised array within a 
H j * function 


E ck 
d ko Ok Ok Ok OK OC OK OX Ck C Ok OE O00 OK KR RRR KK RK RR KK KK ERK OX y 
d x 


* 


* 


main() 
{ 


scauceincenumbers[5] = { 1, 2, 3, 4, 5 ); 
int test; 


test=0; 
while ( test < 5 ) 
{ 
printf ("%3d,",numbers([test]); 
testt++; 


Strings 


à A string is a group of characters: Many computer langua 
b variable to handle strings. C does not. 
terminated with the value 0. 


ges have a special type of 
In C, a string is an array of type char which is 


The value 0 ^as the character representation V). 


If we wish to have a string to hold the name Ni 


gel we can do this by initializing an 
array’ 


char name(] = (UNO, CE, Wey OSU, DLO Oy} 
Note that the last character in the arra 


naracte y is not enclosed in single inverted commas. This 
is because we are giving it the nume 


ric value 0 not the ASCII value of the character 0. 


The above method of initialization has been used in the demonstration program 035. 


[PSN ISDE LESSEE TST IDE EE Ak Ido Goo kao 
* Program 035 
* Demo of string as array * 


EN ISS SESS TLE 


* 


char name[] = Na On nne DTE 


main() 
{ 


printf (name); 
} 


Such an initialization is, however, some 


what clumsy. C provid i tter 
short-hand way of doing this as is shown ToS ride tar te 


in Program 0352. 


98 


f ;C-0. Gurukul Kangri University Haridwar Collection. Digitized by S3 Foundation USA 


f CK OE CIR CR RII A AIRE RR SK KK DEDE Kd 
* Program 035a * 
* Demo of string as array * 


SO EI IOI UICC IOI IOI UII IO IOI IOI I III II IIS II 
char name(] = "Nigel"; 


main () 
{ 

printf (name) ; 
) 


In this case, everything within the inverted commas is assigned to the array, and the 
Turbo C compiler automatically supplies the terminating 0 value. 


char name [10] 
OFFSET 


0 name[0] = 'T'; 
1 name[1] = 'u’; 
2 name[2] = 'r'; 
3 name[3] = 'b'; 
4 name[4] = 'o*; 
5 name[5] » ' ; 
6 name[6] = 'C’; 
7 name[7] = 0 


TERMINATING ZERO 


ZERO TERMINATED STRING 


Figure 11.2 


Another point which comes up in these two programs is the fact that what we have 
passed to the printf() function is just the name of the array with no offsets given. This 


9 
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| has the address of the start of the array. When printf() gets such an address it starts to 
| print whatever is found at that address and carries on until it meets the 0 value 
| terminating the string. 

| 


This is what happens whenever you use printf(). If you have the following in a 
program: 


printf ("Hello"); 


the compiler will store the string Hello in memory, terminating it with a null character 
(the 0 value). It will then give the address of the string to the function. 


Although the name of the array without any offsets given is the address of the array, 


this is not a pointer. It is a constant reference to an address; pointers are not, they can 
have their values changed. 


We look at strings in more detail in the next chapter on string handling. 


Arrays in More than One Dimension 


i Quite often you will need to work with an array of arrays. A typical example will be 
: when you need to deal with a list of n 


for each name you will be working with. In practice, it is far easier to work with a 
single array, which is an array of arrays. This can be done by declaring a multi- 
dimensionalarray. Such arrays are declared in the following way: 


class type name [1st dimension] [2nd dimension]; 


" i V So, to declare an array to hold 10 names of up to 20 characters each, we would use the 
EN un form: 
A 


static char names [10] [20] ; 


Have a look at Program 036 which demonstrates the use of a character array of two 
dimensions to hold a series of names. 


In this program we have used a new input function. This į 
I 7 S 1S gets(), called get s, not 
gets. This stands for get string and is dealt with in the next chapter, $ 
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J[ Ck e he ke e ke ke ke he ek kh RR e ke e kk de e kk e che Sk het e ek e e e ke IOROO 


* Program 036 * 
* Demo of two dimensional array * 


eR OR RII I RI TR I I RI II III IO I IO a ICI Ite / 


$include <stdio.h> 
char names [10] [20]; 


main () 

{ 
get names(); 
print names(); 


get names () 
{ 


int index; 


for ( index = 0 ; index < 10 ; index ++ ) 
{ 

printf ("%-2d Enter Name : ",index); 
gets( &names[index][0] ); 


) 


print names () 
{ 
int count; 


for ( count = 0 ; count < 10 ; count ++ ) 


{ 
printf("Name number %-2d = %s\n", count, names [count] ); 


Beyond Two Dimensions 


uld stick to just using two-dimensional arrays. In fact, 
lti-dimensional arrays useful. In theory, you 
sions as you want. Turbo C will allow 
ith a maximum of three dimensions 


There is no reason why you sho 
for certain work you will find using mult: 
should be able to have arrays in as many dimen 
this, but many compilers will not, stopping you w. 
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A THREE DIMENSION ARRAY CAN BE THOUGHT OF AS A BLOCK OF 
CUBES EACH OF WHICH CAN BE LOCATED BY ITS CO-ORDINATES. We | 
CAN HAVE 4 DIMENSION ARRAYS BUT CANNOT GIVE THEM 

GRAPHICAL REPRESENTATION. 


Figure 11.3 Multi dimension arrays 


When you are doi | 
een ja F e goin 8 a Statistical problem, 3 | 
three dimensions can be a handicap, but in general practice it is advisable. 


fe becomes difficult. Fir: 


d a fifth di i 
up to 100,000 bytes and your memory is quickly vanishin en and d 7 | 
The largest dimensioned arra i | 
1 i im y which I have worked wi 
yin Tay with under T al 
_ Cimension array. However, it did have very small dimensions and is den 


x int nums [10] [2] (2) (2] [2] (23 (2j, 


I have had Turbo C refuse to accept a five dimension array when the numbers were 
larger. This means that if you are going to work with multi-dimension arrays you 
must give careful thought to the demands they will be placing on memory. 


Passing Arrays to Functions 


You can pass an array to a function in a similar manner in which you pass other 
variables as arguments. However, you must make sure that you declare the arguments 
as the appropriate type to go with the array. 


Look at the following: 


main() 

{ 

char letters[{] = “abcde fghijklmnopgrstuvwxyZ"7 
mix_up(letters); 

order list(letters); 


) 


order list(char list(]) 
( 


Here we have the start of a function order. list(). The name of an array is given as the 
argument in the calling function and this is named as list in the function argument. 
The argument is declared as an array of characters. 


Note here that the size of the array is not given. The array will be initialized to the 
correct size according to the array passed. 


What is important about passing arrays as arguments to a function is that unlike 
variables you are not passing a copy of the variable to the function but the actual 


address of the array. In this case any alteration you make to the array in the function 
will be effective in the main array. Consider the illustration given in Program 037. 


This is quite a simple program. An array is declared called letters, and initialized. This 
is passed to a function which adds one to the value of each character. When it returns 
to the main function the value of the array has altered. If it had been a normal variable 


it would not have altered. 


Fre E re OTI 


* 


* Program 037 


* Demonstration of passing array to function * 


odd UM o Mem eem 


char letters() = "abcdefg"; 


main() 
( 
printf ("$sNn", letters); 


inc, let (letters); 
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| 
| 
printf ("%s\n", letters); : | 
! 


inc let(char incer[]) 
{ 


int i; 
were (( sl SO pal ey 


{ 


incer[i] = incer[i] + 1; 


; i+ ) 


) 


12 


HANDLING STRINGS 


BENE — — 


Having found out that strings are nothing more than a type of array, how do you deal 
with them? Unlike other languages C does not have any specific built in functions for 
string handling. If you want a function to handle a string it has to be written. 


This has two effects. First, basic string handling in C is much more difficult than it is 
in other languages. Second, you can do much more with strings in C than you can in 
many other languages, for the simple reason that if a facility is not there to do what 
you want, all you have to do is write it. 


Fortunately, having established that C does not have any built in functions for handling 
strings, and as strings are dealt with so much in programming, library functions were 
quickly developed to deal with the basic operations. These library functions have 
become fairly standard, to the extent that some compilers are now automatically 
incorporating them as part of the main compiler and not as an included library. 


The basic way of printing à string is to use the printf() functions. To do this (as 
discussed in Chapter 6) you have to pass the address of the first element of the array to 
the function. Note that there can be two ways of doing this. Look at programs 038 


amd 039. 


padanakcasiundecanmntt Soe aera tale mI 


* Program 038 $ 
* Passing of array to print£() method 1 5 


cession e a a 


char name(] = "The © Tutorial"; 
main() 
( 


printf(&name[01); 
) 
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[CCCo kk koc kk kc ko ke ke ke kk kk ck II ko kk ck kc k ck k ck OK ck kek 
* 
* Program 039 


i * 
* Passing of array to printf() method 2 
aiao OCIO ROO KK AGRO EORR ROO GEORG eR eK / 


char name[] = "The C Tutorial"; 


main() 
( 

printf (name); 
) 


In Program 038 we have passed the address of the array by using the address of the first 
element of the array in the form &nam 


work just the same. 


This again emphasises that the name of the array gives the address of the array. It 
should not, however, be confused with the pointers, 


P = "The Turbo c Tutorial"; 
Printf("$s",p); 


à / ed a pointer of type character. We then assign to this pointe 
the location occupied by the character constant so the pointer points to the constant in 
memory. After that the printf() function works as normal. 


- Assigning pointers to Point to constants like 


ing | this is a Perfectly legal and valid move; 
one which is frequently used. What would not be allowed is: 


char message[30]; 


message = "The Turbo 


c Tutorial"; 
printf("$sn 


,nessage); 


Copy it into the array. 
Putting and Getting Strings 


Two very useful and almost universa] 


1 o 
names suggest these put strings and zd eed functions are Puts() and gets). As the 
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To put a string to the standard output (we will start to use that term now rather than 
screen) you need to pass to the function the address of the array containing the string. 
This can be done in one of two ways. Either you pass the array name or a pointer to 
the array. Look at Programs 040 and 041. 


[OR RII RII IK IKK TRI I IT KI KR KKK KK IKE KEKE KEE EEK EK 


* Program 040 ts 
* Passing of array to puts() x 


Ke ck kk oko ok KK kk Ok KK Ok IOI OK OK OK KK KU Ke ke OK OC OK OCIO KK Ke KK X f 


$include <stdio.h> 
char name[(] = "The Turbo C Tutorial"; 


main() 
{ 
puts (name); 


II OK ok III ICICI III IOI III IIIS SI ISS 


* 


* Program 041 
* Passing of array by pointer to puts() 


deck ko kk Kk KO Kk KC Gk IOI IOI Kk IO IT IOI SK OK I Kok ok ok ko Kok ex f 


* 


#include <stdio.h> 
char name[] = "The Turbo C Tutorial"; 


Main () 

{ 
char *ptr; 

ptr = &name[0]; 
puts (ptr); 


) 


One fact you will notice is that, apparently, there is little difference between printf() and 
puts(). Well, there is one big difference which the above programs do not show. Look 


at Program 042. 
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The puts() function wili put a string to the standard output device on your system. 
This is normally the video display, but this could be re-directed. The gets() function 
will get a string from the standard input device on your system. This is normally the 
keyboard, but again this may be altered with re-direction. 


kk KR RK ok kk kk KO KO kk Ok kok 
/ 
kk 


* 


* Program 042 j 
* Comparison of puts() and printf() 


KKK KKK 
KKK KK KEK KKK KKK KKK KK KKK KKK KKK KKK KK KK KKK KKK y 


#include<stdio.h> 
char words[] = "This is a test."; 


main() 
( 
char *ptr; 


printf (words); 
printf (words); 


printf ("\n\n That was with printf now with puts \n\n"); 


ptr = words; 


puts (ptr); 
puts (ptr); 


) 


Enter this program and run it. You will fin 
messages to be printed on the same line. 
The puts() functions, however, automatica 


d that the two printf() functions cause both 
This is because there is no \n for a new line. 
lly supply the new line at the end of a string. 


Often, this can be an advanta 


ge. It can also be a disadvantage. This is the case when 
you do not want a line feed 


or if you want a conditional line feed. 


The complementary function to puts() is gets(). This reads a string in from the standard 
input device and places that String in a buffer. 


A buffer is an area of memory which is reserved for data. The easiest way, but not the 
only way, to create a buffer is to use an array. So, consider Program 043, 


Here we have a buffer of 20 characters cal 
gets() and the input is placed in the buffer b 
have put in. All well and good, 


led buffer. We Pass the address of this 10 
Y gets(). The final part prints out what you 


This, though, is not standard and can create problems with portability. It should be 
noted that this approach is taken with fgets(), which is a companion function of gets(). 


J RACER ICRI kk kk CK ER OK K kk CK CK III Rok IK IIIS SES 
* Program 043 * 


* gets() function with a array as a buffer e 


SIO II IOI IOI IO IOI IOI III III A FI IO IC IC 


#include <stdio.h> 


char buffer[20]; /* Create buffer */ 


main() 
( 


puts( "Please enter your name "ys 
gets( buffer ); 
puts( "Hello" ); 


puts( buffer ); 
) 


The Turbo C library does not support a clever version of gets() which is in many ways 
an advantage, as such variations are non-standard. You could try writing one yourself. 
A. way of doing this is given in Answer 3 in Appendix 4. You can extend this by 
putting in facilities which will allow you to backspace, delete, insert, etc. 


You might also like to have a go at writing your own puts() function. This should be 
quite simple so no answer given. A couple of tips though: use putchar() and remember 
it needs a new line at the end. 


Copying Strings 


One task which you will almost certainly want to do is to copy the contents of one 
string to another. Basically, this is simply a matter of copying the elements of one 
array to another. It can be done in a number of ways. Fortunately, there is one quite 
simple way and the standard C library contains a function to do it. Itis strcpy(). 


In use strcpy() needs to be passed two arguments. The first is the address of the array 


into which the string is to be copied, and the second is the address of the array 
containing the string. Have a look at Program 044. 
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XCkckck ck kck kk k kk 
XOkckckck ck ck kok ok 

XOkckckck kk kc kk kx 

f ROCK kk RK KE . 


ES | 
1 
* Program 044 : | 
* Copying strings 
d pacco ION TTTTTER TOT 
kkk 


#include <stdio.h> 

char name([20]; 

main () 

{ 
char buffer[20]; 
printf("Please enter your name "); 
gets( buffer ); 


strcpy( name,. buffer ); 


puts( name ); 


The program demonstrates that the Sstrcpy() function works, but there is not really much 
point to it. You might as well just print out the contents of buffer rather than copy 
them to name, then print them. If, however, you want to do a series of inputs then the | 
ability to copy over starts to become useful. Look at Program 045. | 


Here we have declared a multi-dimensioned array of characters called name. We input t0 f 
a buffer, then using pointers to provide the address, copy from the buffer into the name | 
array. The final part prints out the list of inputted names in reverse order. | 


TOO ISSO AS IK KARR ARR ERE R EEE ERA j | 


* Program 045 


* Copying strings second demo * 


HR SITE TALE TD 


c3 | 


#include <stdio.h> 
char name[5] [20] ; 


main() 
t 
char buffer[20], *ptr; 
int count; ; 


ia 
for ( count = 0; count < 5; count ++ ) 
( Sae i 


printf("Please enter a 


gets( buffer A 

ptr = &name[count] [0]; 
strcpy( ptr, buffer ); 
) 

for ( count = 4; count 
{ 

ptr = &name(count) [0]; 
puts( ptr ); 


) 


Joining Strings 


Another task with strings is that of joining them together. 
many languages allow you to do it by using 


Joining two strings together is technically known as concatenating them, so the 
function to do it is called strcat(. 


PRIOR ROGA KK UR UR EO POE C AAA 


* Program 046 


* Demonstration of strcat() 


aera ar rere IIE LASER IIE IE 


#include <stdio.h> 


char name[] = 
char hname(] = 
char buffer[80i- 
maint) 

{ 


strcpy (buffer, name) ; 


strcat (buffer, "marries 


strcat (buffer, hname) ; 


puts (buffer); 
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"Richard Thomas + 
"Janet Rhodes"; 


name "); 


»20; count --) 


This is so common that 


the + sign, but unfortunately, not C. 


Look at Program 046. 


* 


* 


"y; 
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First in this program we copy the contents of name into buffer using strcpy(). Then to 
this we concatenate the string "marries " using the strcat() command. Finally, we join 
on the contents of hname[] and print it all out with puts(). An easy little exercise, 


There is, as always, a slight problem. No check is made by the standard version of 
strcat to see that the size of the target array, in this case buffer, is not exceeded. It 
should not be too difficult, though, to have a go at writing a version which does it for 
you. 


dee cro 
ees = TRS aE 


= — wera 
ipea 


Finding the Length of Strings 


If you want to join strings, it is wise to check that they are not too long first. For this 
you need to know the length of a string. Here, there is a fairly simple function which 
you can use: strlen(). You pass to strlen() the single argument of the address of the 
string and it will return to you the length of the string. 


iy ap PRE 


i Have a look at Program 047. 
| 
if [7 II IOI Ok IOI IOI ROI III OK IO took teak te 
* Program 047 e 
* Demonstration of strlen() * 


UDUUOOOODOOOOOUGOODOOOOOGOOGOG OO OE Go oon / 
finclude <stdio.h> | 
char name[80]; 


main () 
{ 
int length; 


puts ("Enter your name "); 
gets (name) ; 


length = strlen (name); 
printf ("Your name is $&g Characters long 


\n", length) ; 
} 


i 
| 
wh 
| 


This is all fairly simple, 


Comparing Strings 


The fi ' 
E EN pee for string handling that we are going to look at ÍS p. 
does is take two CEN elt function, which is a string equivalant of ==. M. 
it returns another value. Look CEN they are the same it returns 0, othe 
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* 


* Program 048 


* Demonstration of strcmp() 
fet KO Ck kCk ck ck ck ck ck ck kck ck ck ck ck Ck k k ck kk ckck k ck ck K Ck ck Kok ck ko k ck kok oko kokok / 


* 


#include <stdio.h> 
char answer([80]; 


main () 


{ 
static char capital[]-"London"; 
puts("What is the capital city of the United Kingdom?"); 


gets (answer); 
if ( strcmp( capital, answer) == 0 ) 


puts("That is correct. "); 
else puts("That is wrong"); 


) 


This is a basic program, but one which demonstrates how to use the function. You 
pass, as the argument to the function, the addresses of the arrays holding the strings. If 
the strings match you get a zero back, otherwise some other value. Actually, the value 
returned is the difference between the ASCII code for the characters, which explains why 


you can have a negative value returned and gives some indication how the function 


works. 


Concatenation of Constant Strings 


th old style C was that if you were setting up string 
constants, especially for messages, you had to be very careful about how you entered 
them. The classic C compilers would not accept breaks in your lines, unless you 
escaped them. Turbo C is much more friendly. Study the following: 


One of the major problems wi 


char *cptr; 
"This is a message to be displayed on the " 
points during the run 


cptr - 
"screen at different\n " 


"of the program.\n It contains line feeds 


"and formatting information.Nn It will be 
g by Turbo C."; 


" 


"handled as one strin 


tring. When you give the command: 


Turbo C will read all this in and handle it as one s 


puts(cptr); 


you will get: 
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This is a message to be displayed on the screen at different | 
points during the run of the program. 

It contains line feeds and formatting information. 

It will be handled as one string by Turbo C. 


This facility in Turbo C for the concatenation of constant strings makes code far easier 
to enter and read. 


' 


13 


FILES 


A file basically is a sequence of data. As far as C is concerned this is all that is 
involved in the handling of files. Where they exist is a matter for the programmer, the 
operating system and the hardware, but not for C. 


START END 


| »»—— SEQUENTIAL DATA — —*» | 


BASIC FILE STRUCTURE 


figure 13.1 


This results in you, the programmer, having a great deal of freedom and very little 


assistance from the language. 


mebered, is that all input and output is handled as 
hat you type in comes from a special file which is 
and the display to the screen is also sent to a 


The other point which must be re 
files. So far as C is concerned, w 1 
designated as the standard input device, 
special file, the standard output device. 
There are three things you can do with a file: you can open it, you can access it, and 
you can close it. 

You do have to say exactly how you want to open it, whether to read it or to write to 
it; but you are still opening it. 

ect support for these functions in the language. 


: ide dir : : 
CER doc pb en ded in the standard function library. The functions 


Fortunately, the support is provi 
used are: 
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fopen() 


and: 
fclose() 


Once a file has been opened it may be accessed with any one of a number of C 
functions. The main ones which you will fird in the standard library are: 


fprintf() 
fscanf() 
fputs() 
fgets() 
fgetc() 
fputc() 


You should be familiar with these. They are the standard input/output routines we have 


been working with until now but with F added to the front, although their workings are 
not always quite the same. 


With some compilers, 


file access is even easier. Turbo C can use getc() and putc() as 
the basic I/O for all fil 


€ access. You do not need to use fgetc() and fputc(). 
This is true of most compilers in their structure, but some have built in ‘error’ checking 
to force you to use the file form of a command if you are passing it a file pointer. 

Look at Programs 049 and 050. 


* Program 049 
* Writing to a disk file using putc() 


a RRR ERS eR peli x oe ae OOOO OG KARE / 
#include <stdio.h> 


char message[] = "This is a test of writing to a disk\n"; 
main () 

{ 

int count; 

FILE *fp; 

char ch; 


count = 0; 


fp = fopen("holdtest, nyn 


NF 
while( message [count] 


dc 0) 9 


ch = message[count]; 
putc(ch,fp); 
count ++; 


fclose(fp); 
} 


This is fairly simple. We have declared an array message to hold the string "This is a 
test of writing to a disk". Three variables are declared: one integer, a file pointer and a 
character. The integer variable count is set to 0. Next, we open the file "holdtest" with 
fopen(), it is opened in the write mode, "w". The value returned by fopen() is assigned 
to the pointer fp. 


File pointers are the way you tell C which file you are working with. They are a 
pointer to a special type of structure (we look at structures in Chapter 17) which holds 
information about the file you are working with. The C calls used make use of this 
information to find the position in which they are located in the file, which file they 
are working on, and the mode in which they can access a file. 


The while loop is set up which will continue until we come to the end of the string. 
Remember, the last character in a string has the value 0. The value of each character in 
the array is assigned one at a time to ch, then this is written to the file with the putc() 
function, the character ch and the file pointer fp being passed to it as arguments. The 
value of count is increased and the loop repeated until we get to the end. Finally, we 


| close the file with fclose(). 
This is fairly simple. Now look at how we read it back in Program 050. 


VIX ROCK DERART REY SEER ee TAT 
| * 
| * Program 050 
E * Reading from a disk using getc 


| x * 
| E E KR OE ORO ADR KDEDE ITO A DEERE RAT I 


* 


**x*/ 


| 
| *include <stdio.h> 
| main () 

| { 

| char message[80], chs 
int count; 

| BIER vsfosp 


count = 0; 
fp = fopen( "holdtest","r"); 


(ch = getc(fp)) != EOF ) 


while( 
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Fr, E = 


message[count] = ch; 


count ++; 


) 
message[count]-0; 
printf("$s",message); 
fclose(fp); 

) 


There is nothing really surprising here. You should be able to follow it from Program 
049. There are just two points to consider. First, this time the file is opened in read 
mode, that is the "r" argument to fopen(). To getc() we pass the file pointer fp as an 
argument. The while test looks complicated but is, in fact, fairly simple. Study ita 
bit and work it out for yourself. Second, notice we add a zero value to the end of the 
string. The reason for this is that a string must end with the null value and we stripped 
this off when we were writing it to the disk. Remember the while test in Program 
049: 


while ( message[count] != 0 ) 


which means that when it is equal to zero (that is at the end of the string) the while 
loop will not be carried out, so the zero value is not written to the disk. This is often 
an advantage, but occasionally you may want to have the 0 value written to the disk. 
In such cases use the do-while loop structure, where the test takes place at the end of 


the loop, not at the beginning. The final value will have been written before the test is 


The function fprintf() works basic 


ally t i i i 
exception that a file pointer has to be ERES ie function PRO M 


added, so the syntax is: 


fprintf( filepointer, "control String", argument ) 
, s ); 


The file pointer must be included i 
pointed to by the pointer *fp our com Therefore, to print the string "Hello" to the file 


fprintf( fp, "Hello" hg 


As scanf() is the complemen functi : 
function to fprintf(). In this ae OC fscanf() is the complementary 


take input of a character from a aS ee the addition of a file pointer. So, to 
variable ch our command would be: to by the pointer *fp and assign it to the 


fscanf( fp, "$c", &ch ); 
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There can be a problem with fscanf() on some operating systems. The C language 
expects the end of a file to be marked with a designated marker, normally -1. This is 
the case in Unix where all files are a sequence of characters, and the last position in the 
file is marked with the End Of File marker (EOF) -1. Unfortunately, with other 
operating systems this is not so simple. 


The result of this is that on some operating systems if you are using fscanf() you will . 
not find the EOF. We therefore prefer not to use fscanf() for disk access. 


Accessing a file, character by character is quite practical, but also quite long-winded, 
especially when you are dealing with a number of strings. Here we can use the 
functions fputs() and fgets(). 


The function fputs() is fairly straightforward to work with. You have to pass it the 
address of the string and the file pointer, so the syntax for it is: 


fputs(string,filepointer); 


There is no real problem using this. The only major difference between this and puts() 
is that unlike puts() it does not write a \n' newline character to the end of the string. 


The counterpart function fgets() is more complicated than gets, and also has a surprise 
up its sleeve for the unwary programmer who does not read the technical 
documentation. fgets() needs three parameters: buffer address, maximum number of 


characters to read, and then the file pointer. 


With fgets() the string will be read from the file and placed into the buffer until either a 
newline character is encountered or the number of characters defined in the maximum 
number of characters to be read -1 have been read into the buffer. This, of course, 


reflects the clever versions of gets() which we looked at earlier. 


urn value for End of File. It does not 


The surpri hich fgets() holds in store is the ret 
Hee of String value, NULL. Look at 


return the EOF value, normally -1, but the End 
Program 051. 


t.doc. You will have to create this file in 
ble to use any file produced by a standard 
t file produced by the Turbo C editor. 


Here we are reading a text file called testtex 
Order to try this program out. You should be a 
word processor in ASCII file mode, or a tex 
There is no reason why you cannot use it for text processing. 


The program is fairly simple. We start by defining MAX as being 80 and then define a 
character array called buffer to be 80 characters. 


- Program 051 is on the next page - 


CC-0. Gurukul Kangri University Haridwar Collection. Digitized by S3 Foundation USA 


[3 III I IO EI IO IOI III II III IIIS IOS IIS 


* 


* Program 051 
* File read using fgets() 


Se III III III I III CII kkk kkk kkk IOI IO TOR kkk IK / 


* 


#include <stdio.h> 
define MAX 80 
char buffer [MAX]; 


main () 
{ 
FILE *fp; 


fp = fopen("testtext.doc","r").; 


while( fgets(buffer,MAX,fp) != NULL ) 
{ 
puts (buffer); 

} 

fclose(fp); 

) 


In mai i i 

m ed tg apis M ed then the file to be read is opened using the "r" 

Then the while loop $ xh i iapa OPen is anen Ato the file pona 

ih M aln S and a test set up for the return of NULL which would 

ES Uude ched the end of the file. Whilst we have not, the string held in 
€ screen using puts(). Finally, we close the file using fclose(). 


One po tal ul th use ose I W. Turbo C and 
in ibo t e of fcl 
Si 0. he format for this ith 


fclose ( filepointer A 


, 


The file pointer 
c ns ae ee nee each file closed Specifically. With many older | 
all the files being closed. out any parameters being given. This will result In | 
The function of closin 
. E all i 
with the call fcloseall(), open files is performed in Turbo C and similar compilers 
Now look at Program 052. 
This is a simple program for i 
: F nputtin 

A6 rointsist g text then 
of poin g ich should be noted. To FER. E 3 Re Therearea Wr 

an Program we will- go through ! 
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[FRI ROI K EK kk KK o EK KKK ok IRON) LERRA TA EDIT 
* Program 052 
* Base for text editor 


BARKER IRE KER RIK KKK KK CK KK CK KK Ek KK CK A KK TCR T 


* 


* 


#include <stdio.h> 

#define CLS printf("$c[2J",27) 
#define MAX 80 

#define LINES 300 


char text [LINES] [MAX], buffer [MAX]; 


main() 

{ 
get text (); 
store text(); 


) 


get text () 
( 
char buffer[MAX].*ptr; 
int x; 
CLS; 
x = 0; 
while( x < LINES ) 
{ 
gets (buffer); 
ptr = &text[x] [0]; 
strcpy( ptr, buffer); 
if (buffer[0]--0) break; 
Xtt; 


) 


| Store text () 
| { 
FILE *fp; 
int x; 
Char *ptr,chr,chl; 
| Chr="\n't; 
| x-0; 
fp = fopen("text","w"); 


| while( x « LINES ) 
] { 

Ptr = é&text[x] [0]; 

fputs (ptr, fp); 

Putc(chr, fp); 

if (text[x] [0] == 0) break; 
Xtt; 


) 
fclose(fp); 


) 


The program starts with the preprocessor declarations to include the stdio.h header file. 
"This contains the prototypes for the file handling functions and the type definition of 
FILE, 
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The next line carries a definition for CLS. Here we come to a point of disagreement 
amongst many C programmers. We have here a definition of a function call which is | 
made quite often in many programs: a call to clear the screen. The call here is for the 
Amstrad PC running under MSDOS. If you are using a different operating system and 

| computer you will have to check what the terminal control sequence is on your 
i machine. You will notice in this define definition we have not included the semi- 
colon at the end. This means that when we put CLS into the main program text we 
must follow it by a semi-colon. There are some C programmers who state that calls 
like this should have a semi- colon included in their definition, and so you do not have 
to put them in the inline call. This is very much a matter of personal preference. It is N 
1 recommended that you do not include the semi-colon in the definition but put it on the 

i ` programming line, then you become used to always putting semi-colons in the 

; | program. Next we define MAX as 80 and LINES as 300. These two definitions are 

i| used in the initialization of the arrays text and buffer. 


There are two working functions in this program, get text() and store text(). The 

function get. text() takes an input of text and places it in the array text. This is done 

until either the array is full, while(x « LINES), or the first character entered in a line 

has a NULL value. This can be obtained by just pressing return. This produces an 
A empty string, with gets() just inserting NULL at the first position in the string. 

The second function Store text() writes the text to a file called "text". This is opened 

d y write mode set. An important point to note in this function is that we set 

eee A M chr to be equal to the new line character \n'. Then, after writing 

mon. S VUE with the fputs() function we write a newline with the putc() 

£as reason for this is that fputs() unlike puts() does not add a newline to the 


String. We do, however need one to re i 
s : place the carri i ue 
input. We therefore add it with putc(chr,fp). M 7793 


usually be PRN or LPT1 under MSDO RS 
you have problems, COE ae xm but this is Not always the case. With Unix 
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Anyway, as an MSDOS system is being used to write this, we will work with the 
MSDOS file name. Basically, all we have to do is open the printer as a file for output 
(that is one to write to) and send the output to it. Look at Program 053. 


[RR RR IR IK kk kk KC Ck Ck CKCOk KOk kck ck kck ch ko kck ck ck ck k CK kok kk kk ko kok 
* Program 053 * 
* Hard output to printer * 


IORI kk KK Ck kk Kok ko hok kk ok kk ko kk Kk Rok Kk Ck kk OK ko ROO f 


finclude <stdio.h> 
#define MAX 80 


char file[] = "testtext.doc"; 
char printer[] = SCEMU 
main() 


( 
char buffer [MAX]; 
FILE *fp,*fpo; 
long offset; 


fp = fopen( file, "r"); 
fpo- fopen( printer, "w"); 
while( fgets(buffer,MAX,fp) !- NULL ) 
( 
fputs (buffer,fpo); 
) 
fcloseall(); 
) 


Here we take the input from a text file called TESTTEXT.DOC which we created before 

for the file reading program, and we output it to the file LPT1 thus obtaining a print 

out of TESTTEXT.DOC on the printer. If you have a problem with this not working 
` check what your printer is designated as in your system. LPT! is the designation of 
the parallel printer port-on the Amstrad PC 1640HD20 on which the program was 
| developed. You will probably find the designation will be either LPT] or PRN, but if 
you are using a serial printer, or a second printer card, it will be different. 


You can use basically. the same method to direct output to any device file of which you 
know the name. So if you had a modem connected to the serial port (which is called 
COMI) to send the file via the modem you would replace LPT! in Program 053 with 


COMI. 
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Adding Things On 


So:far, we have opened files, written to them from the start, and read them. 
Unfortunately, these are not the only tasks you want to do with files. Sometimes you 
want to add data onto the end. Well, you can. Instead of using the "w" parameter to the 
fopen() function to write, you use "a" to append. Look at, Program 054a and b, enter 


them and run them. 


[OI CK KIC RC IOI III III IIR ISSIR EIS 


* Program 054a P 


* Demonstration of append. Part 1 * 
Ck kc kk oko ck Kk kk kk ko kc ke ke koc kk kk OI OI ok kc kc ko xk f 


#include <stdio.h> 
char mesl[]-"This is the first line.\n"; 


main() 

{ 
FILE *fp; 
int i; 


fp = fopen("ftest","w"); 


while( mesl[i] != NULL ) 
{ 
printf ("%d",i); 
putc( mesl[i], fp); 
itt; 
} 
fclose(fp); 


printf("That is the end of part one 


Ne 


4 R MR OO a 
* Demonstration of append. Part 2 $ 


ROW Rk ee 
BESESSRERRA RRR ERE E 
RRR Re 
kkkt 


include <stdio.h> ; 


fp = fopen("ftest","a"); 
1-20; 


while( mes2[i] != NULL ) 
( 
printf("£td",1); 
putc( mes2[i], fp); 
i++; 
) 
fclose(fp); 
printf("That is the end of part two."); 


Finding Out Where You Are 


It is often useful to know where you are in a file. This is especially true when you are 
doing random accessing of a file. The function ftell() returns the offset of the file 
pointer from the start of the file. Look at Program 055. 


[Coke ko ec eoe ke ke kk kk kk ke e kk Kk Oe e Oe kk e kk Ke I kk ak 
* 
* Program 055 


* Demonstration of ftell() x 
XCRCk kk II ok ke ke kk Kok Kk KK KR OK RC KK ROCK KORR IO II IK: f 


#include <stdio.h> 
#define MAX 80 


Char file[]-"testtext.doc"; 


‘Main () 
{ 
Char buffer [MAX]; 


long offset; 
FILE *fp; 


| fp = fopen(file,"r"); 


While(fgets(buffer,MAX,fp) != NULL ) 
{ 

Offset = ftell(fp); 

Printf("$d ",offset); 


| 

| 

| Puts (buffer); 
) 


felose(fp); 
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Random or Direct Access 


All the file work we have dealt with so far has been on the basis of sequential access: 
starting at the beginning and reading or writing to the end. The only variation on this 
theme has been the use of the append mode to add data onto the end of a file, but here 
also we have written onto the end. Sometimes it is useful to be able to read or wnite 


something from the middle of the file. | 


This ability to go directly to a specific part of a file is called random or direct access, 
The function ftell() which allows you to find out where you are in the file is useful in 
this respect. More useful, though, is the function fseek(). This enables you to place 
the file pointer to a specific position in.the file. 


To do this, fseek() requires that you pass it three parameters: the filepointer, an offset, 
and a value telling it-how to use the offset. The standard syntax is: 


P filepointer, offset, how); 


The filepointer is fairly simple. You have been using this already in this chapter. The 
offset and how can cause confusion so to start with we will just cover the basic way of 
doing it. This.is using how with a value of 0 in which case the offset has a value. 
which represents the number of bytes from the start of the file. "Look at Programs 056 
and 057, enter them and compile them. Note that if you are working with a compiler 


other than Turbo C you may have a different set of include files and you will need 0 — | 
consult your documentation, | 


kin 
/ De LER RDU CE A RE T Bee IH a RC 


* Program 056 


* Random writing of records to a file X 


NES * ERU KDE i // 


* 


$include <stdio.h> 


#define MAX 80 | 


#define CLS printf ("$c [23", 27) 


char buffer [MAX]; 
char names[10] [10]; 


main() ‘ 
{ 

get_name(); 

store name(); 


) 


get name() 


( 


int x,y,2; i 
char *ptr; ih 


CLS; 
for (X = OR X < UOTE) fi 
( 
printf("\nEnter Name "); Tg 
ptr = &names([x]) [0]; f | 
gets(ptr); i 


store name() 

{ 

FILE *fp; 

int 1, 60.57 

char *pt 

CLS; 

puts ("Storing Names"); 


fp = fopen("workfile","w"); 


mow (ab e Op sb g WO_ ots) 


(Gri: c ab MZ 
fseek(fp,off,0); UA 
ptr = &names[i][0]; 
fputs (ptr,fp); 
putc('\n',fp); 

) 

fclose (fp); 
) 


oo X 
| IJ kk ke kc KK KK KAEI K UK X KR KA RKI KK OK DK Gk ic coa 


* Program 057 E 


* Random reading of records from à file 
XCk TOK kk X X X k kk kk / 


* 


CKCk ko kk Ok kc kk KK I I IOI IO IO FOR IK IO IO 


#include <stdio.h> 


| Char buffer[12]; 


Main () 
{ 
FILE *fp; 
int i,off; 
fp - fopen("workfile","r"); 


xe ( Ao xe a > Of de 
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AM 3 us 


ore = (qum) z 12% 
printf("\nOffset = $d ",off); 
fseek(fp,off,0); 

fgets (buffer, 10, fp); 

puts (buffer); 

) 

fclose(fp); 

) 


Let us now consider at what these two programs are doing. 


Program 056 takes an input of names and stores them in an array. This is all very 
simple. However, there is no check to stop you trying to put in a name bigger than 
the ten characters allocated to it. Try writing a check into the program for yourself. 


The next part of the program then stores the array to disk. Here though, instead of 
storing it in a normal sequential manner, it uses direct access. Each name is stored 
starting at a byte in the file which is 12 bytes further on than the start of the last name. 
This is achieved by setting off which will be passed as the offset parameter to fseek() to 
the value of i multiplied by 12 where i is the number of the entry in the array. The rest 
of this section is very much the same as in earlier example programs. 


One interesting point remains. You will note that after using the fputs() to write the 
string to the file, we use a putc() to write a newline character to the file. The reason for 
this is that we are using the fgets() to read back. This will end its read when it finds 
the newline character. Without such a control you may find yourself getting rubbish 
characters at the end of the read. Try removing the putc() and see what happens. 


Now the names are in and stored. What next? Have a look at the file. The result will 


using this. In this program the Fee the second program and looked at the file 


Having looked at th i A 

the offset and cce Ee let us look at the other ways of using 
ERE 5 IS to move the file poi sition 

Position. Movements of this kind are quite en RR 

If the how parameter to fseek s 


O has th 
number of bytes to be moved from i cM Hm 


relative to its present 


the offset will be interpreted as 4 
n of the file pointer. If the offset 


is positive the file pointer will be moved forward towards the end of the file, if the 
offset is negative then it will be moved back towards the start. 


The other value that how can be given is two. In this case the file pointer will be set 
to a number of points from the end of the file, and the file pointer must be negative. 
Look at Program 058. Í 


[BR IR I IR EON KK KK IK kkk k SATE E SE 


* 


* Program 058 
* Using fseek() to read a file backwards * 


FO III I III III II I IOI IOI II A IA IK / 


#include <stdio.h> 
char ch; 


main () 
{ 
FILE *fp; 
int hold,off; 


fp = fopen("testtext.doc","r"); 
Off =) =i); 
for (hold = 0; hold < 100; hold++) 
{ 
fseek(fp,off,2); 
ch = getc(fp); 
printf("$&c",ch); 
Oif 
) 
fclose(fp); 
) 


This reads the last 100 characters from a file backwards. You must make sure that there 
are at least one hundred characters in your file testtext.doc as we are setting the how 


parameter to fseek() to 2 and offset has a negative value. 


- Figure 13.2 ison the next page - 
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TEL 91n3jq 


(2'001-'dj)xees 


ON3 DOES NOILISOd LYVLS 


l 

l 

l IN3HHfIO 
NOILISOd MIN 


(L'O0L' dj)yaasy 


ana ! 001 NOILISOd ; LYYLS 
! 1N3HHfO 


(0 ‘004 ‘ dj) 3eesj 


NOILISOd 
INSYYNd l 


i 
NOILISOd MAN 


- first and second parameters of the function main 


14 


THE COMMAND LINE 
ARGUMENTS 


It is fairly common to want to pass an argument to a program when the program is 
invoked from the command line. For instance, if you are using a database program like 
Lutterworth Software's Microfile you might invoke it with the command: 


m agency. 


In this case you are passing the name of a data file 'agency' to the program 'm' as an 
argument on the command line. 


Such arguments are known as 'command line arguments’. Information about command 
line arguments is passed by the operating system to the entry function of the invoked 
program. In the case of C this is the function main(). 


To make use of the command line arguments which are passed' to a program the 
function main() needs to be told two things. First, how many arguments there are and 


second, where to find them. This is achieved by two special variables. These are the 
Q. They can be called anything you 


like, but by tradition they are usually called argc and argv. In Turbo C these are 


usually declared as: 


main(int argc, char *argv(] ) 
( 

although if you want to you can still use the older form to keep compatibility with old 
Source code: 


main(argc,argv) 
int argc; 
char *argv[]; 


( 
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Tn 


E 


In these declarations we meet something new: a declaration of an array of pointers. 
What we have in the declaration *char[] is a declaration of a pointer, which itself points | 
to an array which is made up of pointers which point to strings. This is complicatec 

and many C programmers ‘become totally lost with them. For the time being, just 
accept that it works; you can find out more about them later. 

Look at Program 059. 


[CR Ck ke ke kk kk eek kk ok Ok Ok Kk RC Ok III IOI IO KIKI IK KH 


* Program 059 x 


* The passing of command line arguments 


FOR RK RI ITOK IOI II IIIT OR OR KR  / 


* 


#include <stdio.h> 


Main(int argc, char *argv[)) 
( 
intei 
printf("The number of arguments is %d\n",argce") ; 


for ( i = 0; i < argc; i++ ) 
{ 
printf("Argument number %d ac 2 %s\n",i,argv[i]); 
^ ; 
) 


siens here is that you pass a series of arguments on the command line and they 
gether with a statement telling you how many there are. 


There are some interesting points here. The C s 


program name. This is the case u d 
MSDOS below version 3 MA 


tandard is that argv[0] points to the | 
Unfortunately, neither CP/m nor | 


include 
not included Turbo C in rta macro for getc() in Turbo C. If this is 
eT than make use of inline code. 
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| [RRR RIOR IOI IOI I Ck k ck K CK Ok kOK Ck Ok Ck KOXCK KK I 
* Program 060 * 


* Demonstration of command line arguments e 


Kk TI IORI III TO TOI ok KC ko k II ko kc ko II TK kk ick KK ok Kk ke f 


#finclude <stdio.h> 


FILE *fp; 


int count; 


main(int argc,char *argví]) 
( 


if ( argc <= 1 ) /* Test if arguments passed x/ 

{ f 
char name[30]; /* Set up buffer for file name */ hid 
printf("Enter file name "); 


gets (name); 


process (name); 


) 
else /* Arguments have been passed */ 
( 
| int i; 
for (i= 1; i < argc; itt) /* Set up loop to process 
* arguments. 
x/ 
{ 
process (argv[il); 
} 
} 


Process(cnar *fname) 
{ C 
count = O0; 
fp = fopen(fname,"r"); 


while (getword()) 
( 


count++; 


) 


fclose(fp); 


mber of words in $s is %d\n", fname, count); 


printf("\nThe nu 
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getword() 

{ 
.int flag = 0; 
char let; 


while ( ( let = getc(fp) ) != EOF ) 
{ 
switch (let) 
{ 
case 32: /* Space, */ 
if (flag) return (-1); 


break; 

case '\n': /* Newline */ 
if (flag) return (-1); 
break; 

default: 


Le Wiliag d) flag = 1; 
} 
} 
return (0); 


) 


ieu is Me with argc and argv to indicate that command line 
are expec’ declarations of argc being of int and argv as an array of 
pointers to type char. Now for the interesting part. me" E i 


: about a major improvement 
not have a try and see what you can pace Mto counting tabs, etc., as words. Why 


Passing Numbers 


One point about command line arguments is that often you will not want to pass a 


string, but a number, to the program. Unfortunately, the command line argument only ; t | 
works with strings. What is needed is a way to change strings to numbers. This is i 
provided by the function atoi(). Example Program 061 is written for Turbo C but NI 
should work with most standard compilers. T 


[RRR RK IHRE KEK kk kk SR KD KK Sek X KK RACE TASS x ED DE Eo KC ui 


* Program 061 * 


* Passing numbers * 


FOI IO I KC ko KK IO II IO IOI III III ok II I ICICI OI II ek Jf Wu 


#include <stdio.h> i 


main(int argc, char *argví(]) b 
i d 


int i,total,num; 


total = 0; n 
for ( i = 1; i < argc; i** ) i 
{ 

num = atoi( argv[i] ); 

total = total + num; 

printf ("Argument $d has the value $dNn",i,num); 
) 


printf ("The total of %d arguments is td\n",argc,total); 


) 


use the function atoi() to return the integer value 


This is fai derstand. We 
EE Ne run this program passing it four or five numbers 


represented by a string. Compile and 
as the arguments on the command line. 
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15 


MESSING ABOUT WITH 
BITS 


A great deal of real time programming concerns handling information at the bit level. 


In this chapter we look at some aspects of such operations. One problem is that C 
does not have a standard function for the display of binary information. 


showbits 


The function’ showbits() displays the bit contents of a byte. Have a look at Program 


062, enter it, compile it and ty to work out what it is doing. Then save the function 
showbits() in a file called showbits.c. 


* Program 062 
* Demonstration of Showbits 


OES ESE ESSE RR 


/ 
main() 
{ 


int num; 
num = 0; 


while ( 1 ) 

{ 

printf ("\nEnter a nu 
scanf ("&d", Enum); 
printf ("Yn"); 

if (num < 0) break; 


if (num > 255) conti 
showbits (num); 


mber "); 


We aE: TEE. EENE 


nue; 


APSE RS Oo ME s ndation USA 


| 
| 
| 


[I Ck KC Ck kk kk kk ko ke Ck ko k kk kk ko kk kk ok ke IO Kk Kk 


* function name  showbits x 
* arguments single character variable var  *- 
E * 
* output to stdout x 
e * 


* The function takes a character variable which * 
* is passed to it as an argument and displays e 
* a printout of the bit pattern * 


Ok Ck kk kkk kkk KCk Kok ck ck Ck KCk Ck Ck ck k ck IO IOI kk ck Ck ck k ck k k ck X k ck ck kok kc k y 


showbits( char var ) 


{ 
static unsigned char mask[8] = { 1, 2, 4, 8, 16, 32, 64, 128 Ta 


int bit; 


unsigned onezero; 


for ( bit = 7 bit >= Eb. om) 

{ 

onezero = mask[bit] & var; 
printf("$c", onezero ? '1' : '0' ); 


| ) 
| 


Looking at Memory 


which although trivial could form the 


Program 063 shows an application of showbits() V ) | 
allows you to obtain a binary display 


basis for a more useful function. This program 
| of memory. 


* kx 
UK SKK UK CK OK kk UK CO OCDE FR ROR KE DEOR ER XAR ERR ERU UU UU * 


* 


* Program 063 


* 


* Read memory in binary 


KKK 
X KK GEO KC CK Ie K IRAK LK RAO KD REOR II * / 


| 
| 
| # include <stdio.h> 


main () 

{ 
char *ptr,d,c,k; 
int start, flag; 


Printf("Enter start location "); 
scanf ("$d",&start); 
Printf("Xn"); 

Ptr - start; 
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while ( d i= 27.) 


( 
if ( k == 0 ) printf("$d : " ptr); 


/* If at the start of a line print value of pointer */ 


/* Assign value pointed to by pointer “to 


c = *ptr; 
* a character variable. 
/ 
showbits (c); /* Display binary values of bits xy 
ipsins DA 
flag = 0; 
while (!flag) 
{ 
d = getch(); 
if ( d == 27 ) flag = 1;  /* Exit loop if Esc is pressed */ 
if ( d -- 32 ) flag - 1;  /* Exit loop if Space is pressed "/ 


if ( k == 6 ) 


k = 0; 
printf ("Vn"); 
) D 


/* If six v 
alues have be printed Set k to 0 to start new line x/ 


) 
) 


#include «showbits.c» 


z an error i * : 
start to the pointer. warning on the assignment of the integer variable 


Another fact in this whi i 
Anot dur bus might find useful is that we have included the showbis 
although you could (if you wanted to) Sm e Prodi programming ert 
Ane € Dile at the start, A though Ë 
. A general rule to 
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put at the end. 


| The reason for this is simple. Header files contain only declarations and defines. These | 
may be wanted by the functions which come later. This means that you must put | 
header files before you code. Why else would they be called header files? Code include Iu. 
files.often need to make use of variables.declared-in-the main.code. In.this.case they — i | 
must-come. after the main. code. For-this-reason a rule has developed that all code i 


include files are put.at-the-end-of-the-code. 1 


A second important point, is that having them in this position makes debugging much 
easier. We look at this in Chapter 25. i 


The Bitwise AND Operator 


The & symbol is the bitwise AND operator. In the bitwise AND operation the two 
values are compared bit by bit. If both bits in the values are one then the equivalent bit 
in the result will be set to one, otherwise it will be set to zero. Have a look at 
Program 064. 


| 
| if 
| ig 
| that only header files are put at the start of the program file and code files are always I 
| | 
1 


[Ck CKCk ok I k ek Kk KK kk CO Ck KC CK OK CK IOI II IIR IK IIE i 


* 


* Program 064 


* Demonstration of bitwise AND ji^ q^ : 
E HE ck kk kc kk II kc KK Ok Kk KK RO ok ke k k IO dé X AR KR kk kk Ak o e kk / 
fe 


* 


main() x X 


| char a,b,c; 
int fnum,snum; 


Printf("Input a number up to pes y 
scanf ("%d", &fnum) ; 
printf£("\nInput a number up to 
Scanf("$&d",&snum) ; 


295 HA 


OE ae ee eee 


a = fnum; 
b snum; 


J 


| printf£("\n\nFirst Number is ‘VG 

| showbits (a); 

i printf("\nSecond Number is  "); 
showbits (b); 

| printf("\nThe AND result is "); 


C=a 6&5 b; 
Showbits(c); 
printf ("\n\n"); 


#include <showbits.c> 
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Testing Bits Set 


It is possible to test if a speci 
bit set in a mask variable an [ 
returned if the bit is not set in the tes 


test variable — 10011001 
mask variable 00000100 


& result 00000000 


This can be used within if tests by setting a mask variable to the appropriate value to | 
test for the required bit. Consider Program 065. | 


fic bit is set using the & operator. If you have a single 
d & this against the test variable, the value O will be | 
tvariable. Consider the following illustration: 


——— IR tg = a 


[ROI E e IOI ck IOI ROCK XC IOI III TOI IO IIR IK Kok oor 


* Program 065 * 
* Demonstration of masking using & x 
KI I IO II OI IR tO Ok kK KO kck ko k kk / 


main () 

{ 
int val,i; 
static char mask[8) = (1, 2, 4, 8, 16, 32, 64, 128); 
char a; 


val = 0; 
while ( val != -1 ) 
{ 
printf("Enter a number "); 
scanf ("%&d", &val) ; 
if ( val > 255 ) continue; 
a = val; 
for( 1 = 0; i < 8; i +4) 
{ 
if ( a & mask[i] ) 
( 


a. 


printf("Bit number sd is set.\n" 


) ri); 


le ie 


) 


‘Compile and run this program and study how it works 
E. . ° 5 : 
. Switching Bits Off 


e other use of the & operator i i 
opcra ~ & operator is to switch pi i 

ish to switch off set to 0, with the res à (m E his case you have the bit yo" 

values used to switch spe ific bits off are: 


NT 


bit number off decimal value 
0 254 
| 1 253 
| 2 251 
| 3 247 
| 4 239 
5 223 
6 191 
7 127 
Have a look at Program 066 which displays the bits of an input value then switches the | 
| required bit off if set. | 
[OI III ROCK OK OK IIR OK OK IK II IIIS RI IOS IIE $ 
| * Program 066 E 
| * Demonstration of switching bits off 2 
| EKIA OO I RE DE e E A I III IO E e k e e e ee e e e k sd 
| 
| ` | 
| main () | 
{ | 
| static unsigned char omask (8]=(254, 253, 251,247,239, 223,191,127}; | 
| 
i char a; | 


| int val,bit; 


| 
| val = 0; 
| while (1) 
{ 
do 


( 
printf("Enter a number "); 
Scanf("&d",&val); | 
if( val == -1 ) exit(0); 
) while ( val > 255 && val < 0 ); 


do 

( 
printf( 
Scanf("&d",&bit); 

) while ( bit < 0 && bit > 1): 


"); 


"Which bit do you want to turn off 


pri ; lected is ', oma 1H 
i : $d\n", sk[bit t : 
intf ("Mask value se ^ 
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printf ("Current bit pattern is D 


showbits(a); 

printf ("Nn"); 

printf ("Current mask pattern is : M; 
showbits(omask[bit]); 

printf ("Nn"); 

a &= omask[bit]; 

printf("Switched off pattern 19 g We 
showbits (a); 

printf ("\n\n\n"); 


include <showbits.c> 


Notice in this example how we make use of a never ending loop while(1) which is 
always true, and escaping from the loop with the exit() function if a certain condition is 
met. This can often be a better way of handling tasks than putting the test in the while 
statement. 


One area where this ability to switch bits off is very useful is in stripping word 
processor files. A number of word processors like Wordstar make use of setting the 
high bit on certain letters. This is apparent if you use the type command under 
MSDOS to view a Wordstar file. Program 067 will strip the high bits off a Wordstar 
format file leaving you with ASCII text. 


D working of this program is fairly simple. A file is read in, one character at a time. 
me S ter is then ANDed with a mask which has been set to switch off the topmost 
it. To do this we set mask to 127. The result of this is then written to another file. 


A slightly more complicated pro i iple i 
gram, but one which uses the same principle is 
EE xcd mi enables you to display a Wordstar file to the screen one screenful at 
A ormat. You might like to consider combining both programs so that 
you have a tool to view a Wordstar file at the same time as you write a stripped copy. 


V EEEE DEAE AE AELA AAD ICKOEK E GEN E AE b AK Kk 
kkkkx* 
* Program 067 

* Program name stripws.c 


* 


* 


character if set, 
to the output file. 
deo ok oe o e e x 


and writes the Character e 


kkk kk 
GM ERE RR Nan KRANE Ka 
***/ 


* 
* format stripws «inputf ‘ 
i putfile> <outputfile> * 
* The program reads an input file character b ; 
* character. It strips th V 
2 e high bit off any * 
* 

vicit 
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include <stdio.h> 


main(int 
{ 


argc, char *argv(]) 


FILE *fp in, *fp out; 
/* Declare file pointers for input and output files. 


E 
di 
char in let, out let, mask; 
int count = 0; 1 | 
| 
mask = 127; /* Set mask so only high bit is not set */ 4 j 
/* bit pattern is 01111111 */ j | 
ane! 

if ( arge i935 th 


{ 
stripws <inputfile> «outputfile»"'; 


puts ("Usage 
exit (0); 
j 


/* If two files are not give as arguments, exit. */ 


abe (( § strcmp(argv[1],argv(2])) | 
puts("Files must have different names. "); f 
exit (0); I 


) 


/* Check file names are different. */ 


fp in = fopen( argv[1], "r"); 


puts ("Cannot open © 


if ( fp in == 0) | 
( 
puts ("Cannot open input file "); 
puts( argv(1] ); 
exit(0); 
) 
fp out = fopen( argv[2], "Ww"; 
if ( fp out == 0 ) ; 
| 
utput file QE | 
| 
| 
i 


puts ( argv[2] 9; 
exit (0)7 


) 
printf ("Stripping file $s of high pits set.\n", argv[11); 
| 


100 characters. A 


puts (“Each dot = 


143 | 


while ( (in let = getc( fp in )) t= EOF ) 


. 
out let = in_let & mask; 


putc( out let, fp out ); 
countt*; | 
DE comms 2S 10019) | 


putchar('.'); 


printf("\nStrip of file completed. Output in %s.\n", argv[2]); 


fcloseall(); 


[RK IKK Ck Ck kk KK k Ck k k k CK Ck K Ck Ck k k KCk k X X ck kok ck ko 


* Program 068 P 
A * 
* Program Name viewws.c x 
* * 
* Usage viewws <inputfile> * 
* * 
* viewws reads an input file and displays it id 


* one page at a time on the Screen. 


x 


LEE QUUD IG KDE oon / 
$include «stdio.h» 


int line count; /* Declare lina come as MD as ie ds 


* increased in main () 
*/ 


but reset in page() 


main( int argc, 


char *argv[] ) 
{ 

FILE *fp in; 

char in let, out let, 


mask; 
int lets; 


aS c MOS ES Ser pit Pattern to 01111111 */ 
if ( argc != 2) 


( 


puts( " Usage E vis 
s WWS < i " 
exit (0); filename » ) 


Sey sum v fopen( argv(1],"r"); 


age ( Bon eo ) 


{ 
| puts("Cannot open input file "); 


exit (0); 


printf ("$c(2J",27); /* ANSI Clear Screen Command */ 


| line count = 0; 
| lets = 0; 
| THE T 
| while ( ( in redi getc(fp. in) ) f= EOR) i 
| t i 
| out let = in let & mask; /* Switch off high bit */ "Wi 
i | | 
putchar( out let ); dot 
| 4 
| lets-tt; Í 
| 
| if ( outlet ss ND) | 
| t i 
| line count**; | 
| lets = 0; 
| ) $ 
| if ( lets >= 80) 
( 
printf ("Nn"); 
line count:**; 
lets = 0; 
) 
if ( line count 77 23 ) pagel: | 
) 
to return to Dos "); 
puts("End of file, press space Dac | 
| 
t= 32 ) | 
eine ( ( tates = getch() ) | 
D | 
| 
| 
fcloseall(; 
E! 
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ye sae. a 3 


[RIK KK Kk Ck KK RCRCK CK RIOR XX RIO CARO IR ROCK OK KE REX 
i * 
* function name  page() 
* 
* 


* 
* arguments passed none 


5 g ^ 
* The function page prints the end of screen * 
* message then waits in a while loop for the A 
* space bar to be pressed. When pressed the * 
* screen is clearéd using the ANSI sequence * | 
* and line count is reset to 0. * | 


Ck CK kk kk kk kck ck KCk k KCk X KCk Ok KCk kck k k KEK KKK kOK Ok k k X KKK k ko ko ko / 


page () 
{ 
char ch; 


printf("Press space bar for next screen.") 


while ( ( ch = getch() ) != 32 ); 


printf("$c[2J",27); 
line count - 0; 


The Bitwise OR Operator 


With the bitwise AND ; j 
Musis 0 ^ i Er both bits had to be one for the result to be one. With 


yee or ie l. Of the bits is one then the result will be one. The symbol for | 


Switching Bits On 


The operator generally used to switch hite a. : 1 
dn CMM y O switch bits on is the bitwise OR operator |. Have a look 


* Program 069 


* Demonstration of 1 
Switching bit 
s 
CUR EES j 
ORO ke / 
main() 
{ 
static unsigned 
char imas = 
char a; a "y 


2o As Os IG An 64, 1289) 


: int val, biz; 


do 
| ( 
printf("Enter a number "); 
scanf ("%d", &val); 
y if( val == -1 ) exit(0); 
) while ( val > 255 && val < 0 ); 


| 
| do | 
| ( 
| printf("Which bit do you want to turn on  "); | 
| scanf("&d",&bit); M 
| ) while ( bit < 0 && bit > 7 ); | 
Í ae 

a = val; 

printf ("Mask value selected is : &d/n",imask[bit]; | 
| printf("Current bit pattern ig g "yg 3 
showbits (a); i 
printf ("Nn"); i 
| Printf ("Current mask pattern 1G g A | 
| showbits(imask(bit]):; | 
print Nn | 
a |= imask[bit]; | 
printf("Switched off pattern is : "); i 
showbits (a); i 
printf ("\n\n\n"); | 


) 


| ^ 
Clearly, this is essentially the same as Program 066 that we used to switch bits off, 
but this time we have a different set of mask values and we are using the bitwise OR 


operator |. 


The Bitwise XOR Operator 


More complicated than the bitwise AND and the bitwise O 
rator. The symbol fo 


give its full title, the exclusive-or ope e m 
complication here is that it will result in the setting of the resu 
the operand bits is set. 


R is the bitwise XOR or to 
r this is the carat ^. The 
It bit if one or other of 


its, one set to zero and the other 
th had been one then XOR will 


y, if we have two b 


To try a in thi learl 
try and explain this more ¢ abe 


to one then XOR will set the resultant bit. 
Not set the resultant bit. 


See how this works on a byte set of bits. 


first operand 00101100 
second operand 10100110 | 


XORed result 10001010 
147 


CC-0. Gurukul Kangri University Haridwar Collection. Digitized b 


"M 


AC NET TERT g 


Toggling 


A frequent use of the ^ operator is to toggle a bit. Consider Program 070. 


[RIK ck kc ke kk ke kc eK kk ok kc ke Kk TOR II IO I KIT IR KK OEC CK KK Ck KKK 


| 
* Program 070 * | 
* Demonstration of toggling of bit * 
* using XOR bitwise function * 


Ok k KKK k ck k ck kck kk KK kk ckck k k kk k KCkck kk KCk kCk kck K k k k Ck k k ck X k ko k / 


main() 
( 


char flag,mask; 


inten 
flag = 1; 
mask = 1; 


Os (( à = Op al « sp six. }) 
{ 
printf("Current value of flag is "); 
newline(); 
flag ^- mask; 
printf ("Toggled value of fee; ii Qo 
newline(); 
ise (( Paw) 
{ 
printf("This time round this is done."); 
printf ("\nThe flag is set.\n\n\n") ; 


showbits (flag); 


showbits (flag); 


) 

else 

{ 

; Printf("The flag is not Set so do nothing\n\n\n") ; 


delay(); 


newline() 
v ( 

é printf£("\n"); 
) 


delay() 
( 
long j; 
for 


(Co) a 100000; 444), 


The Ones-complement Operator 


The - symbol, the tilde, is the ones-complement operator. This is a unary operator as 
it affects only a single variable. What it does is change all the ones in a byte to zeros 


and all the zeros to ones. 


So the number two has a binary value of 0000010. The ones-complement of two has a ET 
binary value of 1111101. Hu 


[Wk Kk o RR ROOKIE EORR EX OUO Scc QD QE 


Have a look at Program 071 which shows this. | 


* 


* Program 071 


* Demonstration of ones-complement 
dk ok I III III OITA III I IIIA f 


* 


eI I X Ck KK OI IK XI 


| main () 

| ( 
unsigned char a; al 
unsigned int val; H 


while(1) 

( 

| do 

| ( 

printf("Input a number between 0 and 255 og 
scanf("$d",&val); 

if (val == 1000) exit(0); 

printf ("Nn"); 
anie (0 val < o ii va NN 
ama 

printf("The bits are 
printf ("Nn"); 


"); showbits (a); 


* 
Ch Ea; /* ones complement of a */ 


printf("Now they are "); showbits (a); 


printf ("\n\n\n") ; 
) 


Clearing Zeroth Bit 

is i junction with a 
One of the most common uses of the ones-complement is in conju 
bitwise AND = Bite the zeroth bit. As the ~1 will have every bit set except the 
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th can always clear the zeroth bit no matter how many bytes a variable 
zeroth, you 


occupies, with: 


result - num & (-1); 


Note the use of brackets here. It is standard practice to include unary operations within 
brackets like this. 


Shifts 
There are two C operators for handling bitwise shifts, these are the left shift operator | 
<< and the right shift operator >>. Both operators require a positive value of the | 
number of bits to be shifted. As an example: 

<<2 

will shift two bits to the left, whilst: 

>>3 

will shift three bits to the right. 

Study Program 072 which illustrates their use. 

JAK OIRO OI IOI III III II I IOI EAR I ke ek A 


* Program 072 . 
* Demonstration of bitwise shifts 


SII ISLES SIS E EAT ona eor / 


* 


* 


main() 
t 


unsigned char let,res; 
int i; 


let - 1; 


for (191; T Ae: ) 

{ 

res = let <<i; 

printf(" %d left shifted by ", let); 
printf("%d is $2d ",i,res); 
printf("which has the bit 
showbits (res); 

printf ("Xn"); 


Pattern, wj, 


Foundation USA 
e n 


let = res »»i; 


printf("$d right shifted by ",res); 
printf("$d is %20 "ety 
printf("which has the bit pattern. "); 
showbitsilet); 


printf ("Nn"); 


#include <showbits.c> 
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SOME FURTHER 
FUNCTIONS 


Getting Hold of Memory 


When you run a C program, the program grabs hold of a certain amount of the memory 
in your computer. The exact way in which this memory is grabbed will vary with the 
type of compiler, operating system and computer you are using. Basically, one block 
of memory will be taken for the static variables in the program. Above this a block 
will be taken to hold the runtime code of the program. On top-of this will be an area 
known as the runtime stack, which will hold those variables which are not held 
permanently in memory, that is, those declared as being auto rather than static. This 
actually means any variable other than an array, which is declared in a function and not 
explicitly declared as being a static variable. 


So, all that memory is taken by the program. Above this you are liable to have a 
block of unused memory. This is known as free memory. You can 'grab' a section of 
this memory for your own use with the function malloc(). 


When called, you need to pass malloc() the number of bytes of memory that you want 


to use. If the memory is available it wi 
e € 1t will return a voi i t of that 
memory, otherwise it will return the null value. MEO me ster 


Incidentally, notice that the pointer is of 
you have to specify the memory in terms of 
which is a non- specific number of 
malloc() returns a pointer of type char, 


type void. The reason for this is simple. AS 
b i number of bytes, you use the-type void 
ytes type. With older compilers you will find that 


Once you have your memory, 
(We look at how to use it late: 


There is another point which is quite important. In many systems the stack, which is 
where auto variables are stored, is held as part of free memory. You therefore need to 
make sure you do not take up all the free memory with a malloc(), but leave some clear 
for the stack. One way in which you can do this it to keep requesting and freeing 
memory with malloc() and free() increasing the size of bytes taken each time, until you 
get a NULL return, then take a lower figure. 


Arrays Which Change Size 


Until now we have dealt with arrays which have a fixed dimension. This can mean that 
a great deal of space is wasted. For instance, if you declare an array of twenty strings 
each of eighty characters, the total amount of memory needed to hold the array is 20 * 
80 bytes, that is 1,600 bytes. If you have a case where only one of the strings needs 
the whole 80 characters and all the rest are between 10 and 20 characters in length, you 
will have considerable wasted memory. 


An alternative situation, but in many ways worse, is when you have dimensioned an 
array too small. If you have allowed for a list of names to be entered with each name 
not more than 30 characters long (usually an adequate allowance) you have problems 
when you have to enter Ferdinand Michael Johannes Van De Slagharene. You may 
think that such events are unlikely, but there is one fundamental rule in computer 
programming. If you think an event is so unlikely that you do.not have to cover for it: 


it is bound to turn up. 


The answer to both these sorts of problems is to make use of dynamic arrays. Here 
you declare an array of pointers for the number of items you want to hold in the array. 
Then you place your items in memory, having acquired that memory with malloc() and 
address them via the pointers. Have a look at Program 073. 


kK KKK 
OCC eH AA A HER HR RN EP 
* 


* Program 073 
* Demonstration of Dynamic Arrays 


OK Ok ck k kk kk CK KK KC C CK I IK I REIS 


* 


ox Ck ok KO OK Ko Kok / 
finclude <stdio.h> 


#include <stdlib.h> 


#define MAX 80 
fdefine MXPTR 10 


Main() 
{ 


int length, num, count; 
Char *ptr[MXPTR], buffer[80]; 
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oS 


ee 


for ( count - 0; count « MXPTR; count ** ) 


printf("Enter name $d ",count); 

gets (buffer); 

length = strlen(buffer) + 1; 

if ( ( ptrí[count] = malloc(length) ) == NULL ) 


{ 
puts("Out of memory space."); 
break; 


) 


strcpy( ptr[count], buffer ); 
) 


num = -1; 
puts ("To end name display enter 0 else enter number from 1 to 10"); 


| 
while ( num ) | 
{ 
printf ("Enter number of name you want : "); 
scant("$&d",&count); 


getchar(); 
D (( eane C= A) break; 
L£ (count < 1 || count > 10 ) continue; 


puts (ptr [count-1]); 


) 


First, we define the maximum n 
This is done by defining MXPT 
which are quite normal. This i 


The next part of the program takes the in is i insi 
ra put of ten names. This is done inside a for 
loop. The name is inputted to buffer with the 8ets() function. It can be any length UP 


to 80 characters. Th int i > 
EC eda $. The whole point is to allow a buffer big enough to take whatever 


Our next step is to reserve memory to put the string into. This is done at the same 
time as we make a test to see if there is enough memory to store the string. The line: ` 


if. ( ( ptr(count] = malloc(length)) == NULL ) 
sould have been written as: 

»tr[count] = malloc(length); 

if ( prt[count] == NULL) 


and it might be easier to follow in that form. What we have done is make a call to 
malloc() for length bytes. If this call is successful it will return a pointer to the start of 
the reserved memory. If it is not successful, it will return NULL. If NULL is returned 
a message is printed to say that we have run out of memory and the break command 
takes us out of the loop. 


If there is sufficient memory, the string is then copied into the reserved memory 
obtained by malloc(). This is done using the function strcpy. 


In the second part of the program we set num to -] then use this as the value ina while 
Statement. This has the effect of setting up an indefinite loop, as the condition will 
always be true and no other operation is carried out on num. You should be able to 
follow the rest without problems. However, do not forget our friend the dummy 
getchar() to take care of the return character after the scanf(). The first time I tried this 
Program I forgot to include it, and had to reset the computer to escape out of the 
Program. 


the if test to check for valid numbers. 


Also notice the use of the continue statement in 
f a while statement. 


This can be very useful for jumping back to the start o 


Have a look at the program, try it out, then amend it. See what happens when you es 
different things. How can you get out of entering names before you have put ten in? 


Try other modifications as well and see what effect they have. 


grabbed by malloc(). Experiment with 


There memo 
Minero i t. Have a look at Program 074. 


Putting data directly into memory and retrieving i 
ed in it on a character by character 


Here, a block i d text is stor cte 
, of memory is grabbed and tex : 
asis. An important MENS note is that before the block of memory is used it Is 


filled with NULL. This is done because there is no way that we can know what is in 
€ memory. 


| 
| 


RERO, YRDQADORDUATA LADIR A KEKR KK RR ok ok ook II RO 


he 


* Program 074 


© Demonstration of using malloc() 
FO III OTIC IOI III I IK / 


* 


KOkCk RIK kk Ok KK e 


#include <stdio.h> 
#include <stdlib.h> 


#define MAX 80 
#define MX 500 


main () 


{ 
int length, num, count; 


char ch,*ptr,*p2tr, buffer[80], *sptr; 


if (( ptr = malloc(MX)) == NULL ) 
{ 

puts("Insufficient Memory"); 
return; 

) 

printf ("Memory grabbed n"); 

sptr = ptr; 


——M 


ch - NULL; 
printf("Memory start %d “u ptr); 
^s ( count = 0; count « MX; count ++) 
*ptr = ch; 
ptrt++; 
} 


printf ("Memory filled with Null, Memory end %d \n",ptr); 
> 5 


ptr = sptr; 


puts("Enter Text"); 
buffer[0)=NULL; 


while( egets(buffer) ) 
{ 


count = 0; 


fe buffer[count] t= NULL) 


*ptr = buffer[count]; 
ptr++; 
count++; 


puts("Printing."); 
for ( p2tr = sptr; p2tr <= ptr; p2tre* ) 


{ 
ch = *p2tr; 


printf("$c",ch); 


) 


[JERS that Sk SK KK EC SK HE DE CRGO WR DK DEKOR UKUATUR DRUCK OU X ED XAR EIST SY 


* function name egets () ^ 


* x 


* arguments address of character array "s 


* 
* egets() takes the input of a string and places* 
* in the buffer passed as argument. It returns * 
* 0 if the ESC key has been pressed during input* 


| FoR I CK CK c KC kc RC KOC CROCO KC I DE KK OK XU OK FOIE IESE co 


egets( char buf{] ) 
{ 


char let; 


int i; 
doces 0; 
do 

( 
let = getch(); 
if ( let == 13) 

let = 'Mn'; 
buf[i] = let; 
i=i+ 1; 
if ( let == 27) 
return (0); 

putchar( let ) 

) while ( let != 'M' ); 


buf[i] = 0; 
return (1); 


eee o 

ne ies. oo ihe Ea ik Pet alte of the ESC will not 

"Put before the ESC key depression will be ignored, but t f M deb. 
entered into the string. In many POETE Mem of many text editing 

Want to use ESC as a way out. This is à fairly standard feature 

Programs, 


157 


CC-0. Gurukul Kangri University Haridwar Collection. Digitized by. 


Ti "TT 


—————Àá a eR E EE 
pres NEEDS BS OE ae 


What egets() does is read the characters one by one from the keyboard into the array. If 
you press ESC the value 27 is detected and a return is made of the value zero, 
Otherwise, when you press RETURN the value one is returned. 


Another point you should note is that we test for RETURN and then put ^n' in as the 
value of let. The reason for this is that the depression of the RETURN key gives the 
ASCII value 13. Under MSDOS the return does not automatically generate a line feed, 
so 13 is not equal to Y. The replacement is therefore undertaken so you get both a 
carriage return and a line feed. Note this reflects the situation with Turbo C under 
MSDOS on the Amstrad PC1640HD20. On other systems, with other operating 
systems and compilers, the situation may be different. You will have to check. 


Forcing One Type into Another 


One of the problems with type casting for variables is that often the variable you want 
is not in the form that you want it to be for a specific use. This is a common 
occurrence in graphic programming where you often need to assign a specific value to a 
pointer. x 
The way around this is to cast one variable onto another. This is a process by which a 


copy of a variable is assigned to a variable of a different type. The syntax for this 
operation is: 


variable_type_a = (type) variable type b 


where type is the type of the first variable. So if we have a character pointer ptr, and 
we wish to assign the value held in the integer variable num to it, the line would read: 


ptr = (char *) num; 


whilst to assign the value of num to a character called ch we would use: 
ch = (char) num; 
This last operation would only be strictl 


integer. Most compilers, but not all, 
integers and integers to character. 


y required if num was of a type float and not 
will allow you to assign character values t0 


Here we have used the typedef s 
to a character. pedet command to define char. pointer to be a type of pointe! 
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iS Sl OK OR IOIOOROOR GR KK Kok DE DE 


x program 075 x 
* Demonstration of casting " 
id * 
* Program name hexdump z 
s * 
* This program produces a dump of memory in * 
* hexadecimal format. & 


SEO CKOXCKOCKCKCKCKOCKCK KCk Ck KC k k KCKCK CK Kk KCk k KK kCKCK Ok Ck kk kk ko f 


#include <stdio.h> 
finclude <ctype.h> 


#define CLS printf ("%c[2J",27) . 
#define SETCOLOR printf("$c[44m$c([37m",27,27) 
$define NORMAL printf ("%c[Om", 27) 

fdefine TRUE 1 


unsigned char *start ptr, *current ptr, membuf [16]; 


main() ut 
: i 
notes(); 
start(); 


while ( TRUE ) 


run(); Lr 


* E RRR KO X X X X 
* j : x 
PRR KA EI kie ue eK KK OR KIRIK KKK ORO ORE DEAE DARE 


notes() 


f 
The function notes() displays 8 screen O 


1 i b 
help text. Return to main program i5 Y 
loop 


aox cxx ko ok ex f 


* 


Pressing the ESC key which exits à 


5 Pe kx 
ALE kk kk ko ek KK II I IO OX ES 


notes () 
( 


CLS; 


tents of memory "); i 
printf("\tThe program displays the: con 
A t Nn"); 
Printf("in hexadecimal de EU 
printf("Ntand in ASCII. Er 
printf("is displayed. nM ; 


A A n\n")? 
printf("\tThe choices are: \ 


ch page a menu OP 
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= eia, m pi lores = 


ESCAG 


* 


* 


start () 
{ 


printf("\t\tG ... 
printf ("\t\tB .-. +e. eee eee ee 
printf ("\t\tF .. 
printf("NENCH ....-.-- 
printf ("\t\tESC 2.1... seer eee ee 


SETCOLOR; 
printf (" 
printf (" 
NORMAL; 
printf ("\n"); 


while ( 


r 


0 


pointer current ptr 


int val; 
char ans; 


CLS; 


printf ("\n\n\tDo you wish to 
printf ("Hex or Decimal? 


do 
{ 


getch() != 


21) 


[OOOO III OK ORO XOX OK OK XC II Ok KO KK KO kk X kk 


< 


ans = tolower ( getch() ); 


Putchar (ans) ; 


) while ( 


if 


(ans 


( ans == 


printf" 


4c OND) BG 


the ) 


\n\n\nEnter Start address in hex * 
EEN EOS STE TREN) 


goto specified location.\n\n" ; 
go back one screen. \n\n"); 

go forward one screen.\n\n") ; 
help, print this screen. mn"); 
Escape to DOS.\n\n"); 


Press ESC to continue"); 
SE 


* 


* 


* The function start() takes the input of an 2 
* integer value in hex or decimal and assigns x 
* this using the cast operator to the pointer je 
* start ptr which is then assigned to the vd 


* 


ROCIO COCCI OI EELE EEEN 


"); 


input start address 
hb A o5 Up 


(ans != 'q') ); 


printf("\n\n\nEnter start address in decimal : 
scanf("$*x",&val); 


start ptr = ( char *) val; 
current_ptr = start_ptr; 


Fi I kc ee eR Ke OR AE RI A ITASCA ESS a 


* run () * 
* * 
* The function run() displays one screen at a e 
* time then waits for instructions on what x 


* 


* to do next. 


GO RIOR IOI I II IOI III e e IOI IOI IOI IIIT IT II IIIA | 


run () 

{ 
int line, let, flag; 
char ch, ans; 


CLS; 
for ( line = 0; line < 16; linet+ ) 
{ 


printf ("%04x > "u, current_ptr); 


let = 0; let < 16; lett+ ) 


for ( 

{ 
membuf(let] = *current ptr; 
printf ("%2x u membuf [let])+ 
current_ptr = current ptr + 

) 

printf (" | 8 

for ( let - 0; let < 16; let**) 


( 
3be {( membuf [let] S stil )} 


putchar (membuf {let ) 7 


else 
putchar ('.'); 


printf ("Nn"); 


"); 


1; 


) 
printf("NnNnNnNn") ; 


SETCOLOR; 
printf(" G(oto) B(ackwards) F(orwards) "); 
printf(" H(elp) ESC(ape to DOS) "ya 
NORMAL; 
flag = 1; 
while (flag) 
{ 
ans = tolower(getch()); 


switch (ans) 

{ 

case 'g': 
newstart(); 
flag = 0; 
break; 

case 'b': 


current ptr - current ptr - 512; 
flag = 0; 
break; 


Urug 
flag = 0; 
break; 
ANG 
current ptr = current ptr - 256; 

flag = 0; 
notes (); 
break; 


printf ("\nConfirm you wish to return to DOS ?"); 
printf(" «y/N» "); 


ch = tolower (getch()); 
if ( ch == ty: ) 
flag = 0; 


exit (0); 


current ptr = 
break; 
default: 


Current ptr -256; 


[IRIURE de ec Jo KR a ORI UI IU UE HE LED 
* 
x newstart () * 
x * 


* The function newstart() take the input of an * 


* integer value in hex or decimal and assigns x 
x this using the cast operator to the pointer à 
* current ptr i 


FOI III IO III IOI III IIIT ITO IOI II III 


newstart () 


{ 
int val; 


char ans; 


CLS; 
printf("\n\n\tDo you wish to input start address "); 


printf ("Hex or Decimal? < H / D> "); 


do 

{ 
ans = tolower( getch() ); 

) while ( ans != 'h' && ans Ya "dt y; 

Af ( ams e Om? ) 

( 
printf ("\n\n\ Enter new address in hex : nr 
scanf("$x",&Val); 

) 

else 


printf ("\n\n\nEnter new address in decimal : 7); 


scanf("$x", &vall; 


current ptr =) chav i val: 


i lso provides 

f the use of casting. The program a 
: d an illustration of one of the uses of pointers. 
rks. You will find the detailed.explanation of 


Program 075 includes an illustration 

areal tool for looking at memory, an 
Xamine the program and see how it wo 

Some use, 

a ines: TCOLOR and NORMAL. These are 

ARN EA operations. There are two ways 1n 


making use of the ANSI control codes to set 
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which you can control the screen. In the first, you directly use C to address the 
hardware of your system. This method tends to be very efficient and gives you a great 
deal of flexibility. There is a problem, though, in that it tends to limit your 
application to very specific hardware. The second method which is often used is where 
you make use of the ANSI control code sequence to handle screen operations. You will 
find the approach is slower but it does produce more portable zode. 


The function main() in this program is very short. It calls up two functions which 
initialize the program and then enters an endless loop, escape from which comes from 
the function run(). You will notice that no variables are declared in main(). In this 
case all variables are either global and declared just before main(), or local to the 
operational functions. 


The first of the operational functions is notes(). This informs you of what the program 
is actually doing and what keys to use. This function is invoked either at the start from 
main() or during operation from run(). 


After notes() you come to the function start(). This is where use is made of type 
casting. In this case we take the input of an address from which we want to read the 
memory. This can be taken in either decimal or hexadecimal format. The input is 
assigned to a variable val. This value is then assigned to the pointer *start, ptr. This 
is done in the statement: 


start ptr - ( char * ) val; 


What we are doing here is that we are forcing the type of a character pointer onto the 
value held in val, when it is assigned to the character pointer start_ptr. In fact, as all 
pointers are integers anyway, you could have just done a direct assignment, but this 


would produce a waming at compilation time with Turbo C and some compilers will 
not allow it. 


ane ron run() is fairly simple. It displays a 256 byte block of memory in 
TE d and ASCII format, then waits for a keyed in command, the action to be 
on the key depression being decided in a switch-case statement. These are dealt 


with later in thi : : 
eiim is chapter under Making Selections, but they fitted neatly into this 


Another t is 5 : : 
function E eee used to assign an integer value to a character pointer in the 
wstart(). This is very similar to that done in start 


There are two points about 
initial value to start_ptr this 


The other facility you might like to try adding is a way in which you can edit memory. 
This might mean that you will need to read on further first, but it is something to 
come back and attempt when you feel ready. 


Creating New Types 


It is often convenient to be able to have a type description of a special class of types. 
This can be done with typedef. For instance, if we are using a number of arrays to hold 
strings all of 80 characters we might want to declare a type called strings: 


typedef char STRINGS(80]; 

We can now declare a set of strings with: 

STRINGS name, road, town, county, countrys 
which is the same as: 


CHAR name [80], road [80], town(80], county [80], country [80]; 


Another important point is that many compilers will not accept char * in a cast 
statement. The only way to get a character pointer is to make use of the typedef to 
declare a character and then put that in the cast statement. Even worse, some compilers 
insist that every type declaration in the cast statement must be a declared type. 


Making Selections 


g is to carry outa task in accordance with 
where there is a choice of actions to be 
e value of a variable returned. In such 
f handling the selection using the 


A fairly common requirement in programmin 
a value of a variable. A typical example is 
taken, and the choice made is reflected in th 
circumstances C provides us with an easy means o 
Switch case statement. 

The statement consists of two parts. First, the declaration of the switch, that is the 
Value upon which the test is to be made, and then a list of cases stating which action 
should be taken if the value matches the value in that case. The general structure 1$ 


shown below: 


pee ( choice ) 


Case 'a': 
action; 


break; 
Case 'p': 

action; 

break; 
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case ‘ct: 
action; 
break; 

default: ' 
action; 


Look at Program 076. 


This is a very simple offer of a menu type choice and then the use of the switch case 
statement to effect the selection. It well illustrates the basics of using the statement. 


J[ CRCKCK kk kk kk ek kk RC CIC kk Ck ok kk ek C Ck Ok kk KO Kok 


:* Program 076 E 


* Demo of Switch Case o 
KK Ok Ok Ok Kk KC Ok OK ORK KK XC XC Ko KK CX TOR III Ok e ek f 


#include <stdio.h> 


main () 

{ 
int num; 
char ch; 


printf("Please make your selection \n\n"); 
printf("l - a\n\n2 - b\n\n3 - c\n\n"); 


num = 0; 
while ( ( num < 1) || ( num > 3) ) 
{ 
num = getch() - '0'; 
) 


switch (num) 
( 
case 1: 
ch = 'a'; 
break; 
case 2: 
ch = "b'; 
break; 
case 3: 
ch = 'c'; 
. break; 
default; 
ch = 'z'; 


) 


printf("*cYnWn", ch); 


Often, you may want one of two or three selections to trigger an action. This is quite 
possible in a switch case statement by stacking the cases. Consider the following: 


case 'Y': 

case ‘y': 

case 'J': 

case 'J': 
acceptance action; 
break; 

case 'N': 

case 'n': 
rejection action; 
break; 


Clearly, there are no instructions for 'Y’, 'y or ‘J’. If any of these are true the selection 
will drop down to the first set of instructions following them, in this case the set 
following 'j. The selection of 'N' will result in the instructions following 'n' being 
carried out. 


Such set ups are very useful for user proofing programs. The illustration above comes 
from a program at a point where it is asking for the input of Y for yes. A British user 
might enter Y or y, this program, though, is also in use in Northern Europe, so 
allowance is made for the input of J or j which are commonly used to give a positive 


response. 


You will find a fuller example of using the switch. case statement in the memory read 
program, 075, earlier in this chapter. Go back to it and have another look. 


Jumping Around 


jump to somewhere else in a program. In fact, 


It is sometimes useful to be able to 
s of a program. 


properly used, a jump can greatly increase the effectivenes 


ound inside a program is a command to tell the 


What yo le to jump ar sr : 
eee eS aa ia here to indicate that location. This is done using 


program where to jump to and somew 
LABELS and the command goto: 


Look at Program 077 


x 
KKK X OK XXX 

TA RR eI eek Ge UKEN ENA KARAREN 
* 


* Program 077 A 


* 

* Deme GE Gose qox CX XE I RO RO f 
x*x* 

XPKI M de ok Kk cc kk KK COR KO RR CK ORI OATS 


main () 
{ 


char ch; 

int num, flag; 

Printf("Make Selection WM"); 
Printf("] - a\n\n2 - b\n\n3 7 e\n\n") i 


167 


CC-0. Gurukul Kangri University Haridwar Collection. Digiti 
k : 


START: 
flag = 0; 
num = getch() - '0'; 


switch (num) 


ch = 'c'; 

break; 
default: 

flag = -1; 


} 
if (flag) goto START; 


printf ("%c",ch); 
) 


This basically does the same as Program 076 in demonstrating the switch case, except 
here we are using a flag to indicate if none of the acceptable options. has been selected, 
and a jump to go back to the start of the selection procedure. 


The label START: indicates to the program where it should jump to. Note that the 
Jabel is terminated with a colon. A label may come either before or after the goto, but 
the label and the goto must be contained in the same function. 


Although Program 077 is a useful illustration of how the goto command works, it is a 
bad example of its use. The main use of gotos (many would claim the only legitimate 
use of them) is to escape from deep inside a series of nested loops. Here a goto can 
provide a way out in the event of a major error. The basic structure would be 
something like: 


fore ) 
{ 
for(......... ) 
{ 
do 
( 
while(......... ) 
if(problems) 
goto WAYOUT; 


33 Foundation USA 


In a case like this the goto would escape you from within four levels of loop. The use 
of a break would only take you up to the next level. However it should be noted that 
| in situations like this it might be better to use exit() or return to provide a clean escape, 
although this may not always be possible. 


Another point to consider is restructuring the code to avoid the deep levels of loops. 


There are many software engineers and academic computer programmers who will say 
that you should never use gotos. Experience suggests that such people have had little 
experience of having to write software in the real world, or if they have, are working in 


a very software friendly environment. 


It is valid to say the use of gotos should be avoided as much as possible, but there are 
times when it is the only acceptable means of solving a problem. The situation where 
this is quite common is in real time software which is operating under tight time 
controls. Here, real time software does not refer to much of the financial and banking 


LI 

i 

i 
software which is often described as real time. In such software, response times of over ji HP 
a second are often quite acceptable. What is meant by real time is softwaxe which has a i] 


| to respond within a time period of less than one tenth of a second. n 


When faced with this situation, you often find that the time taken to escape from the 


| depths of a complex loop structure is more than acceptable. In these circumstances you BN 
| em, do so with care, and only after uH 


have to revert to using gotos. If you need to use them, 
you have established that there is no acceptable alternative. 


10 
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MIXED DATA TYPES 


An array can hold a collection of variables under one name. The only problem is that 
they all have to be of the same type. Often, you need to hold together several variables 
of different types . For example, in an employee record the information you want to 
Store is: 


Name String 
Age Integer 
` Male/Female Character 


Here we have three different items which are all connected. They can be held together 
in a structure. 


A structure is essentially a special type of array which can hold several diverse 
variables. A typical example of the use of a structure is where the holding of 
information about people is required. Here the basic information is name and age. 
This gives us two different types of variable which have to be used. The name will be 
an array of characters, and the age an integer. 


-If we want to make this into a Structure, the first task is to give the compiler 2 
definition of the 'pattern' that the structure is going to hold. The pattern 1s 4 


description of the individual members of the structure. So in this case we would declare 
a pattern for a-structure called people as follows: 


struct people { 
char name[80)]; 
int age; 
}; 


In this we are telling the compiler that it wi 
people. This structure will consist of two v. 
array called name and the second member is 


ll recognize a type of structure called 
ariables. The first member is a characte! 
an integer called age. 


struct people member; 


— 


example we have two, the first is member.name and the second is member.age. 


Hp 
Tli 

fn this illustration we are telling the compiler to make a structure of the type (or | i 
pattern) people and give it the name member. It is then possible to address the Al 
individual variables within the structure by their structure member names. In this Í 
| 

| 


If we had declared a structure called family with the pattern people, using: 


struct people family; 


The names would be family.name and family.age. So, in referring to any member of a 
structure the first part of the variable name is the name under which the structure is 
declared followed by a full stop, the second part the name for the element (or member) 


of the structure. , 


Program 078 illustrates the above points. 


paar EO OT 


* 
* Program 078 
* Demo of Structure 
Kok ck ckck kck Kok cKCk kk kk k kk kk ck 


* 


er EKKERT 


#include <stdio.h> 


struct people { 


char name [80]; 2 d 

int age; ; i 

); d 

"a, U 

main () ES | 
i j 

struct people member; ae i 


puts("Please enter members name"); 
gets (member .name) ; 
puts("Please enter members age 
scanf ("%d", member .age) i 
getcha ; k 

ME A E member is şa years ", member .age) ; | | 
printf("of age and the name is "); 
puts (member.name); 


"); 


: a 
IuProgram 078 a structurevis setup with fie F8 people. This pean is tenes : 
to declare the structure member. The rest of the program s E d nee 
the member's name is obtained using gets() with the variable n 


Passed to it to give the address of the array. 

: i ion of code, or the 
Quite often with structures you will only be VEE ea d Gu about things is 
will be global. In such cases it seems a rather lone 2 w eee 
set up the pattern, then declare @ structure. You can do 1 , 
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Servers ff 
[member list]; 
} namel, name2, name...; 


s are being declared at once there is no need for a pattern name. 


Where all the structure 
í g the above form as shown in Program 


Taking Program 078 it can be rewritten usin 
079. 


RUD aaa a aaa mt 


x Program 079 p 
* Demo of Structure 


eR eR RR RA RE RK I KR e / 


* 


*X** 


#include <stdio.h> 


Struct. | 
char name [80]; 
int age; 
} member; 

main () 


{ 


puts("Please enter members name"); 

gets (member .name) ; 

puts("Please enter members age "); 

scanf ("%d", &member.age) ; 

getchar(); 

printf("\n\n\nThe member is %d years ",member.age) ; 
printf("of age and the name is "); 

puts (member.name); 


One ar i i s 
ea of inconsistency amongst compilers is the ability to pass structures e 


parameters to functions. : : 2 
P E RO, ons. Some compilers allow this and will accept the code shown n 


KOK Rk Kk 
/ FRI Ok Kk ok jk IO ok ek kk oe 
A ui BO kk kk 


* 
Passing structures to functio^s 
kk Ck ok kk kok kk kde kk Ck ok ke kk IO ek 
kk 


* 
* 


FORA IK kK Ok / 


P ue «stdio.h» 


struct people( 
char name[80]; 

int age; 
); 


a 


nain 


struct people employee; 


printf ("Enter employee's name "); 
gets (employee name); 

prints ("\nNnEneer employee's age "); 
M nf Csa", employee.age)r 


puts ("Employee's name is "); 
puts (employee .name) B 

puts ("Employee's age is "); 
! printf ("%d\n", employee.age); 


retire (employee) ; 
) 


retire(struct people detail) 
{ 

ant, ret; 

ret = 65 - detail.age; 

printf("&s will retire in sd years\n\n", detail.name, ret) i 
) 
Other compilers will not accept structures as parameters to functions. B cases 
(which seem to cover most compilers at present) you have to pass details of a structure 
to a function by way of a pointer to that structure. 
Whilst with the above method you worked on a copy of the s x =. 
passing a pointer you will be working On the structure elements directly. 
difference must be kept in mind. 


When you have to address the members of a structure using a pointer à new form of 


addressing has to be used. This is the directed to address form ->- 


Have a look at Program 081. 


PE occ 
Program 081 4 
* Demo passing structure? to functions 


* " ó 
using pointers M 


xx 
NEN cu ko Rt ME 


#include <stdio.h> 


Struct people({ 
char name[ 80]; 
int ager 
he 


main () 


0. Gurukul Ka 


struct people employ; 
printf ("Enter employee's name wie 
gets (employ.name); 
printf ("\nEnter employee's 
scanf ("%d", employ .age) i 
getchar(); 
printf ("\n\n"); 
printf ("Employee D Cg 
retire(&employ); 
) 


age "); 
&dNn",employ.name, employ.age); 


retire(struct people *detail) 


{ 
int ret,cage; 
cage = detail->age; 
ret = 65 - cage; 


printf("The employee $s ",detail-»name); 
printf("will retire in %d years.\n\n",ret); 
) 


Here the address of the structure employ is passed to the function retire. Within the 
function the structure members are addressed by the pointer to the structure detail. 


Of course, it is not often that you want to deal with only one item of the type held in a 
structure. For instance, in the above cases you might want to keep a record of all 
employees in the firm. This can be done within an array of structures. Have a look at 
the version of the same program shown in Program 082. 


JR RRR RK I kk Kk KK KC Ok KC KK kk kk KK KIKI XU 
* Program 082 * 
* Demo of arrays of structures 3 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkx/ 
include <stdio.h> 


struct people{ 
char name[80]; 
int age; 
}; 


main () 
- mat 

struct people employ[100]; 
int count, check; 


/ for (count=0; count < 100; 
ic o] P ‘a y 
1 ts("Do you van to e 
{ “to en 
: E ter another record"); 


count ++ ) 


— — —— 


if ( 10K()_ ) break; 


else 


f " " 
printf ("Enter employee's name "); 


gets (employ[count] .name); 

printf ("\nEnter employee's age ON 
scanf("$d", &employ {count].age); 
getchar(); 

printf("MnNn"); 


printf ("Employee ts is ^ È 
$d\n" employ [count] .name, employ [count] .age); 
) 
) 
for 
| p 
retire(semploy[check]) ; 
) 


3 eck++ ) 
( check = 0; check < count; ch 


retire(detail) 
struct people *detail; 
( 
int ret,cage; 
cage = detail->ager 
ret = 65 - cage; 


il-»name); 
« detail 


printf("The employee 55 s. ann, ret) i 


printf("will retire in *d year 


OK() 

( 

char ch; | 
int num, flag; : 
num = -1; | | 
flag = 0; | 


While(!flag) | 


Case 'NWN': 


( 

| ch = getch(); 

Switch (ch) | 
| i 
Case 'y': 
case 'Y'; 
| flag = -1; 
num = -1; | 
| break; | 
| Case 'n': | 

I 
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flag = -l; 
num = 0; 
break; 

default: 
flag = 0; 
) 
) 
"n return (num); 


) 


Here we declare the structure employ to be an array using the form: 
structure people employ[10]; 


This declaration declares an array of structures with the pattern as specified by people, 
which has ten members and will be called employ.’ From here the operation of the 
program is similar to the previous examples, except that the input is handled inside a 
loop and we have the function OK(), which tests fora Yes or No answer.’ 


Getting Values into Unions 


A data type which allows you to enter a value of any type appears to be useful at times 
but it does not seem to be used very much by C programmers. The union is such a 
data type. 


At first sight a union looks very much like a structure. It is set up with a pattern like 
a structure, as shown in this declaration: 


union date ( 
char word[4]; 
int num; 
}; 


The difference between a union and a structure 


TAN me: D above example can hold either a three letter word like 
STN or "AUG" or a number like 1, 12 or 8. It does not matter which yo 
Select, they are both held in the same area of memory. 


is that a union only allows you to hold 


E. i Noni nd some advantage over structures. If we wanted to allow @ 
VN be set up with a pat old the date either in numeric or character form, it would have 
|. bytes of memo red similar to the one above. In such a case it would take f° 
puo y F the word and two for the integer. This would mean that E 
1e Of such a structure would be six bytes. 


| us "e ue for the largest element in the union. In this case, the xo 
Boro ytes. This means that two bytes of memory can be saved. If yOu were 


working with a large number of such unions, say in an array, this could result in a 
sizable saving in memory use. 


The problem with unions is that you still have to specify the correct member of the 
union to receive the correct type of data. You cannot put general input into the union 
and expect it to sort out the storage for you. 


Bitfields 


Bitfields are a special type of structure whose members are fields made up of one or 
more bits. If that seems complicated, do not despair, in fact bitfields are the 
programmer's life-saver if it comes down to messing around with bits. They enable 
you to avoid most of the complications of having to work with bitwise operators. 


Bitfields are described in the Kernighan and Ritchie description of C, but many 
compilers leave them out. There are complications to their implementation so leaving 
them out is an easy solution. Turbo C does provide full support to bitfields in keeping 


with the ANSI standards. 
Consider the following definition of a bitfield: 


struct bitmap ( 
. unsigned bitO : 


unsigned bitl : 1; 
unsigned pit2 : 1; 
unsigned bit3 : 1; 
unsigned nibl : 4; 
unsigned  nib2 : 4; 

4; 


unsigned nib3 : 


) flags, nibbles; 

take up sixteen bytes. Note that the form 
cept for the use of the colon as a 
ga bitfield structure. 


In this we have defined a structure which will 
of this declaration is like that of a normal structure ex 
field separator. This informs the compiler 1t 15 handlin 
will be the bits 0, 1, 2 


; : indivi its, these 
In this bitfield we have defined four pits as individual bits, t : , 
and 3. The remaining twelve bits of the structure are split into three nibbles of 4 bits 


! 5 T 
each. Note that all;have been specitic€ 35 being of type unset d wi 
support both unsigned and ints, the later peing stored in twos comP 

i f 
Two important points to consider are the storage Order of the bitfields and the effect o 
using int rather than unsigned. 
First, the storage order Turbo C stores bitfields from the s pig i ed 
declared in a structure definition is the zeroth bit in the n x S Roe I URN 
Bit 8 in the structure definition is the zeroth bit in the ig 


177 


| 
$ 
i 
|| 
| 


Turbo C follows ANSI in only allowing bitfields up to the size of an int, that is 
sixteen bits, two bytes. Not all compilers follow this form of storage and problems 
may be expected if you are moving between compilers and hardware. 


Second, is a concern when you declare a single bit to be of type signed int. Have a 
look at the following declaration: 


struct bits{ 


Here we have defined a bitfield consisting of two bits. Both have been declared as type 
int. This means they are signed. A single bit can only-hold one of two values, 0 and 
1. In a signed value the two complements system is used, so if the left-most bit is 1, 
then the value is negative. So when you declare a single bit to be of type int, that is 
signed, it can only hold 0 or -1. 


Four bits, normally called a nibble, can hold up to the value 31. In practice, though, 
they are normally used for holding the values 1 to 9 in BCD (Binary Coded Decimal) 
format. This is very useful in many forms of hardware interfacing. 


So much for the theory, let us look at a very simple example of using bitfields shown 
in Program 083. We go back to the question of C having no binary output functions. 
The function, disbits(), can be used in place of showbits(). 


YS VVAEE LEE LES LET CATT CERT LTE a CR E 
* Program 083 


* 


* disbits, demonstration of bitfields * 


Boo STELLA SS 
$include <stdio.h> 


struct bitmap { 


unsigned no 
unsigned n1 
unsigned n2 
unsigned n3 
unsigned n4 ; 
unsigned n5 : 
unsigned n6 
unsigned n7 
) allbit; 


cb Sp SB WD 


PPP PP PP EP 
` 


e. co o 
-- s 


Foundation USA 


int num; 
char let; 


do 
( 
printf("Input a number from 0 to 255"); 
scanf ("%d", &num) ; 
) while ( ( num < 0) Il ( num > 255 ) ); 
let = (char) num; 


disbits (char); 


void disbits( char a ) 
( 


struct bitmap ^"r; /* pointer to structure */ 


r - &a; /* make it point to value */ 


printf ("%d", r-»n7); 
printf ("*d", r-»n6); 
printf (us diu r-»n5); 
printf("$d", r-»n4); 
printf ("%d", r-»n3); 
printf("$d", r-»n2); 
printf("$d", r-»n1); 
printf("$d", r-»n0); 
) 


What we are doing here is making a pointer to à specific type of structure ae 2 B 
Rape cra variable of d differen eM uem warming ne es 
compile, then, use the bitfields to read off the values of the appropriate bits. 


we are addressing via pointers. 
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CODE MACROS 


A. very useful and most powerful aspect of C is the ability to define macros with 
arguments. Such macros enable simple functions to be stated as macros. In fact, if 
you are prepared to put some work into your definitions, quite complex functions can 
be stated as macros. 


The use of code macros has the effect of eliminating the overheads which are part of 
making function calls. These include the call to the function, the passing of 
arguments, and the handling of return values. 


If a program has to frequently undertake a specific type of operation, considerable 
savings on speed can be made by using code macros for such functions rather than 
function calls. This is one of the ways that Turbo C obtains its high execution speeds; 


many of the more common functions like getc() are defined as macros and expanded to 
in-line code. 


There is a price to pay for such savings in speed in that you get a larger amount of code 
in the end. Incidentally, if with Turbo C you want to use the function getc() rather 
than the macro, you can do so by removing the macro from the header file. If you do 
this it is advisable to rename the header file so you have one copy with the macros in 


and one without. The result of this will be smaller 
codi ct yo 
z À Ae e, but you must expect your 


A pu» Re pof ncnion IS one to find the largest of two numbers. This can 
largest (int a, int b) 
{ 

int ret; 

ret = (a > b) 2? a: b; 

return (ret); 


but it necessitates extra typing and in the case of complex expressions, increases the 
difficulty of reading the code. 


A more effective approach is to declare the expression as a macro with arguments. The 
use of such code macros has the effect on expansion of entering the function: in the, 
code, whilst reducing the typing for you and keeping the code legibility. In the current 
example we would define such a macro in the form: 


#define Largest (a,b) (a>b) ?a:b 
When entering our code we would use entries like: 


val = Largest (numl,num2); 


During compilation the in-line replacement will be carried out so that the above line 
will be replaced with: 


Wel = (numl»num2)?numl:num?2; 


de macro does not include any type information. A 
simple substitution takes place of variable names for arguments. Any types are 
therefore according to the declarations of the variables used. This can present problems 
if you are not careful, but it can also be an advantage, especially where you want to use 


the same expression on a range of variable types. 


One important point is that the co 


by the newline character. Where you are trying to 
his can cause problems. The way round this 1s to use 


udy the following: 


Define statements are terminated 
define very complex expressions t 
the backslash N to escape the newline. St 


#define Swap_if_big(a-b)i 


Code macros of this type can become quite complex and can be ees ee 
However, they can make a major contribution to software efficiency, 1 us : 


inatioi i- i finition. 
One point to note is that we have included the termination semi D. i Pa de ; 
The reason for this is that we do not want a terminating E Mp ca tic 
of the expanded expression. By including 1t in the definitio 


expansion. 
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MEMORY MANAGEMENT 


Without doubt one of the most powerful aspects of the C language is the ability to 
manage memory from within your program, to grab hold of chunks of free memory, 
use them for storing data and then to release them. The flexibility given to the 
programmer's handling of data by the ability to handle memory allocation directly is 
enormous. It also means that the subject of memory management has many complex 
aspects to it. We do not intend to go deeply into such aspects for two reasons: first, 
they are beyond the scope of a book which is intended to be a basic tutorial, but more 
importantly, 95% of all C programmers will never have to use them. Should you need 
in depth information on memory management from within C, look at some of the 
books given in Appendix 8, the Bibliography. 


Itis important to understand the concepts behind the memory management functions in 


C. This is especially so in relation to Chapter 20 on the Linked List where these 


functions are used as the basis for constructing such lists. First, a glance at memory. 


TOP 
FIXED DATA 


Figure 19.1 


When a program is compiled, certain memory allocations will take place. These will i 
vary according to a number of factors. In the case of Turbo C, the memory model you | 5 
are compiling under is significant, and with other compilers different reasons will play | 

a part. Basically, the memory is divided into four areas. At the very top of memory | 
the fixed data is held, below this is the program code. There is then a gap. At the 
bottom of memory is the area used to hold variables, this is called the stack. Between 
the top of the stack and the bottom of the code section is an area of free memory called 
the heap. 


Emas v eee m 


Figure 19.1. is just a diagrammatic representation of the basic idea. It is not a 
representation of the memory allocation under Turbo C. The actual method of 
allocation is much more complicated and if you are interested, details are given in the 
Turbo C documentation. This illustration will serve our current purpose. 


= a 
Peg ee 


| As explained above, in the middle is this free memory called the heap. What you need 
isa method of getting your hands on this memory in a form you can use. C supports a 


set of function calls which are called memory allocation functions. These allow you to "Tu | 
grab hold of blocks of memory, and release them as and when required. ) E | 

j 2 ah 
Before going on to look at these calls we briefly consider the difference between Turbo 1 | | 
C and classic C in respect to memory allocation calls. All memory allocation calls t i 
which allocate memory, retum pointers to the start of a block of memory. That block | 
of memory may be of any size. The problem here is that all pointers have to have a j f 
type, but there is in classic C no type for a pointer which points to à block of memory. an 
However, there is a type for a pointer which points to a single byte of memory, the ee 
type char. So the classic C approach has been to give the pointers the type char. This un 
worked, but it could cause problems. For example, if you wanted to store a structure In n | 
a block of memory, you had to allocate the address pointed to by the char pointer to à udi 
pointer pointing to a type struct. This would involve casting the pointer. Hm 
In Turbo C, advantage has been taken of the new ANSI type void. As pointers of type | j 


vV ype y i y f 
i are gener ic i f ct the can be assigned to an type (0) 
M g (that 1S they ha e no Speci 1C t ) i ; : | 


pointer without casting. Therefore, in Turbo C m 
a pointer of type void. This makes programming using memory 

in Turbo C than it was in classic C, although it can pose some P 
when you move code over from classic C to Turbo C. 


ortability problems | 


malloc() B 
stands for 
The most basic of the memory i malloc) m bee oen int | 
memory allocation. To use it you pass to the hee an i Mr function is 
i -— want to grab. e 
Which tells the function how many DES t will return a pointer to the address of 


allocation functions i 


Succes isi is memory tO grab, it : z : : 
| tee ae pis ere d. Should the function fail, usually due to insufficient 
| memory, then it will return a Zero. 


lt 


E 
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MEMORY MANAGEMENT 


Without doubt one of the most powerful aspects of the C language is the ability to 
manage memory from within your program, to grab hold of chunks of free memory, 
use them for storing data and then to release them. The flexibility given to the 
programmer's handling of data by the ability to handle memory allocation directly is 
enormous. It also means that the subject of memory management has many complex 
aspects to it. We do not intend to go deeply into such aspects for two reasons: first, 
they are beyond the scope of a book which is intended to be a basic tutorial, but more 
importantly, 95% of all C programmers will never have to use them. Should you need 
in depth information on memory management from within C, look at some of the 
books given in Appendix 8, the Bibliography. 


Itis important to understand the concepts behind the memory management functions in 
C. This is especially so in relation to Chapter 20 on the Linked List where these 
functions are used as the basis for constructing such lists. First, a glance at memory. 


When a program is compiled, certain memory allocations will take place. These will 
vary according to a number of factors. In the case of Turbo C, the memory model you 
are compiling under is significant, and with other compilers different reasons will play 
apart. Basically, the memory is divided into four areas. At the very top of memory 
the fixed data is held, below this is the program code. There is then a gap. At the 
bottom of memory is the area used to hold variables, this is called the stack. Between 
the top of the stack and the bottom of the code section is an area of free memory called 
the heap. 


Figure 19.1. is just a diagrammatic representation of the basic idea. It is not a 
representation of the memory allocation under Turbo C. The actual method of 
allocation is much more complicated and if you are interested, details are given in the 
Turbo C documentation. This illustration will serve our current purpose. 


As explained above, in the middle is this free memory called the heap. What you need 
is a method of getting your hands on this memory in a form you can use. C supports a 
set of function calls which are called memory allocation functions. These allow you to 
grab hold of blocks of memory, and release them as and when required. 


Before going on to look at these calls we briefly consider the difference between Turbo 
C and classic C in respect to memory allocation calls. All memory allocation calls 
which allocate memory, return pointers to the start of a block of memory. That block 
of memory may be of any size. The problem here is that all pointers have to have a 
type, but there is in classic C no type for a pointer which points to a block of memory. 
However, there is a type for a pointer which points to a single byte of memory, the 
type char. So the classic C approach has been to give the pointers the type char. This 
worked, but it could cause problems. For example, if you wanted to store a structure in 
a block of memory, you had to allocate the address pointed to by the char pointer to a 
pointer pointing to a type struct. This would involve casting the pointer. 


In Turbo C, advantage has been taken of the new ANSI type void. As pointers of type 
void are generic (that is they have no specific type) they can be assigned to any type of 
pointer without casting. Therefore, in Turbo C all memory allocation functions return 
a pointer of type void. This makes programming using memory allocation much easier 
in Turbo C than it was in classic C, although it can pose some portability problems 
when you move code over from classic C to Turbo C. 


malloc() 


The most basic of the memory allocation functions is malloc(). Its name stands for 
memory allocation. To use it you pass to the function a value of type unsigned int 


which tells the function how many bytes you want to grab. If the function is 
successful, that is if there is memory to 


the start of the block grabbed. Should 
memory, then it will return a zero, 


grab, it will return a pointer to the address of 
the function fail, usually due to insufficient 


M rm 


As the function is returning a type other than int, it must be made known to the calling 
function. The way to do this under Turbo C is to include one of the two header files in 
which it is prototyped, these are stdlib.h and alloc.h. If you are not using Turbo C you 
will have to declare the function in the calling function, or give it a global declaration, 
normally as being of type char *, though you should refer to your documentation. 


Now have a look at the Program 084 which provides a basic demonstration of malloc(). 


[RRR RK RR RR RR RR 


* Program 084 x 
* Demonstration of malloc() ol 


FR RK KR FOR KK IO IO x f 


#finclude <stdio.h> 
#finclude <stdlib.h> 


main() 
{ 
void *ptr; /* pointer to receive the address from 
* malloc(). If using another compiler 
* than Turbo C, this will probably have 
* to be of type char. 


lf 
int num; 
while (TRUE) /* Endless Loop */ 
{ 
printf("Enter the number of bytes to grab : "); 


scanf ("%d", &num) ; 
if(num <= 0 ) exit(0); /* get out of program */ 
if (( ptr = malloc(num) ) == 0 ) 


{ 
printf("\nAll the memory has been grabbed.\n"); 


exit(0); 


printf("\ntd bytes grabbed at location %d.\n",num,ptr); 


) 


This program will keep on grabbing memory until you either enter the value zero or 
below for the number of bytes to be grabbed, or it runs out of free memory, 


Running out of free memory is a problem when you are grabbing memory for data 


storage. If, during the run of a program, a number of requests are made for space in 
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memory you are quite liable to run out unless some of the space already used is 
released. The way this is done is to use the free() function. 


free() 


The releasing of memory can be accomplished by using the function free. This 
function is passed a pointer pointing to the address of a block of memory grabbed with 
one of the memory allocation routines. It then releases that block of memory so it can 
be used again. 


coreleft() 


Before we can consider how free works, we need a way of locking at how much 
memory there is. Turbo C supports a function which does this and that is coreleft(). 
This is not a standard function and you will not find it on other compilers. If you are 
working with another compiler, or if you'are writing a program which you want to 
transport to other compilers, you will have to write your own function to report the 
size of memory left. 


The coreleft function is simple to use. Nothing is passed to it and it returns either an 
unsigned int or an unsigned long, depending on the memory model vsed at compile 
time. (See your Turbo C documentation for details on memory model). If vou are 
running under Turbo C, enter and run Program 085 which will demonstrate not only 
coreleft() but also malloc() and free(). 


f oho e he e he he eoe e e je e de e t e t ek Y OG ORCI CN ORC KON GC YO ee © 


* 


* Program 085 
* Demonstration of coreleft, malloc & free x 


‘ct cece ee eee ee ee eee eee ee 0 X X X Crk keke / 
#include <alloc.h> 


main () 


{ 
unsigned long size; 


void *ptr; 


while ( TRUE ) /* Endless loop */ 


( 
printf("WVnEnter number of bytes to be grabbed "); 
scanf("&*dá",size); 


if ^ sige cas Oi) exit com /* way out of loop */ 


Me d = 
EYE 


A 


printf("\nMemory available before malloc() is "); 
printf ("%d\n",corefree()); 


ptr = malloc(size); 


printf("\nMemory available after malloc() is "); 


printf ("td\n",corefree()); 


printf("\nMemory available after free() is "); 
free (ptr); 
printf ("%d\n",corefree()); 


calloc() 


An altermative memory allocation function to malloc(), and one which is much more 
used is calloc(). The name stands for calculated allocation, which gives a clue to what 
calloc() does. 

Basically, it works like malloc() but unlike malloc() it needs to have two arguments 
passed to it. The first is the number of units for which memory must be made 
available, and the second is the size of each unit. This is very useful if you want to 
store, say, two hundred structures of a certain type. All you need to do is pass calloc() 
the number two hundred and the size of the structure and it will go ahead and work out 
how much memory you require and grab it for you. 


At this point you may be about to panic at the thought of trying to work out the size 
of any specific item. Don't worry, C has an answer for you. 


sizeof 


First, before anyone becomes confused, sizeof is a keyword and not a function 
although it looks like a function in code. The usage of sizeof is: 


variable = sizeof ( item ); 


where variable is a variable to which the size is to be assigned and item is an object 
which you want to know the size of. 


Program 086 illustrates the basics of sizeof. 


186 


CC-0. Gurukul Kangri University Haridwar Collection. Digitized by S3 Foundation USA 


SEDEM) o m0) mE-mmBOSTIE^n3aTP =": 3. -—————————- 


[RO IIIT IORI TO TROT ROI IO a ke 


* 


* Program 086 


* Demonstration of sizeof * 
BOXEO eee eoe ole geo dec de koe ee e kk er K RO | ETI 


main() 
{ 
struct test { 
int numl, num2, num3; 
char name([20),street (20); 
) fitest; 


int number; 
number = sizeof ( fitest ); 


printf("The size is $d bytes \n",number) ; 


Here we are using sizeof to find the size of the structure fitest. Notice how we have left 
a space between the keyword sizeof and the first bracket. This makes no difference to 
the compiler, but does make it clear to the person looking at the code that this is not a 
function. 


Using calloc() 


Having obtained a means to find the size of objects we can now have a look at a way in 
which calloc() can be used. Look at the following code fragment. 


include <stdio.h> 
include <alloc.h> 


void *mem start; 


main() 


( 
int num; 
ys 


printf("Enter number of data items :"); 
scanf ("$&d",&num); 
getchar(); 


mem start = calloc( num, sizeof( long 


| This is from the start of a statistics program. Before the start of a run we do not know 
i how many data items are to be entered. The number is therefore input and memory is 
obtained using calloc. You will notice also that in this code use hus been made of 
m= sizeof on the type long. This might seem strange as long has a set size under Turbo C. 
| It does not, however, have the same size on all systems. By using sizeof in the calloc() 
call to give the size of long, maximum portability is obtained across different systems. 


If you are writing software which you want to be portable across a wide range of 
systems and compilers it is often preferable to make use of calloc() than malloc(). For 
instance if you wanted to obtain enough memory to hold one thousand integers, this 
could be done under Turbo C on a MSDOS system with the code fragment: 


start mem - malloc( 2000 ); 


an integer taking two bytes on such a system. If this code was now moved to a 
compiler and system where integers took four bytes, as on some Unix systeras, you 
would only have space for five hundred integers. This could result in problems. 
However, these could be avoided by making use of calloc() and grabbing thc memory 
required with: 


start mem = calloc( 1000, sizeof( int ) );: 


X Now it does not matter what type of system the code is moved to the correct amount of 
E space to hold one thousand integers is always grabbed. 
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LINKED LIST 


One of the problems which faces many programmers is how to cope when you have a 
quantity of data to handle but do not know the scope or extent of that data prior to the 
program being run. A data structure which is often used to deal with this problem i: 
the linked list. 


Figure 20.1 shows the basic structure of a one way linked list. 


POINTER 


POINTER 


END OF LIST 


Figure 20.1 
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A linked list is a set of data elements which are linked together. The location of on., 
one element in the list is known to the program. Other elements are accessed by 
reference to information on their location which is held in the list. | 


The simplest form of the linked list is the one way. In this, each list element consists 
of two parts: a data element which holds the data contained in that element, and a 
pointer which gives the address of the next element in the list. 


In such a list the program only needs to know the location of either the first or the last 
member in the list depending on whether the pointers point forwards or backwards. 
From there it can look at the pointers in each element to find the next element in the 
list. 


The simplest use of this list is where you know the basic nature of the entries which 
will be made in the data element, but do not know the size of thern or the number. In 
such a list each new entry will be added to the last entry. No provision needs to be 
made for deletion of entries or for insertion of entries into positions other than at the 
end of the list. 


An illustration of this is given in Program 087. 
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* Program 087 * 


* Demonstration of basic one way linked list * 
ROKK KKK I OK KKK KK KK RK KK RR KR RR RK RK / 


#include <stdio.h> 
#include <stdlib.h> 
#define TRUE 1 


/* Prototypes */ 


int menu(void); 
void add(void),list(void),get out(void); 


typedef struct a ( 
struct a *next; /* pointer to next 
* record in list 
VA 
char *string; /* pointer to data */ 
) record; 


ning a type called record which will be used to form basis 


main() 


int select; 


while (TRUE); 
( 


select = menu(); 


switch ( select ) 
( 
case 1: 
add(); 
break; 
case 2: 
aistiO 
break; 
case 3: 
get out (); 
break; 
default: 


zoid add() 


[i 
‘ 


record *current; /* pointer to current element */ 


char buffer([225]; /* buffer to hold data input */ 
int len;, 


while (TRUE) /* endless loop started */ 

( i 
puts ("Enter data item, RETURN to finish "); 
gets(buffer); Y 


if(buffer[0]--0) return; /* escape from loop */ | 


if ( !elements ) /* This is the first entry 

i AR E 
len = strlen (buffer);  /* get length of d i 
current - malloc( sizeof (record) ne XN 
q — E 
/* set start pointer to first re 


start = current; E 


current-»string = mallec{len); 
/* get memory to hold data */ 


strcpy(current->string, buffer); 

/* copy contents of buffer into reserved 
* memory. ; 

oy 


current->next = (record >) 0; 
/* this is last record so points nowhere */ 


elements++; 
/* increase count of elements */ 


else /* not the first record */ 


len = strlen(buffer); 
current = start; . 
/* set current to first element */ 


while ( current-»next != 0 ) /* while not last 


* record 
x 


current = current-»next; 


/* move forward one record */ 


/* At end of list make new record */ 
current-»next - malloc(sizeof (record) ); 
current = current-»next; 


/* move forward to new record */ 


current-»next = 0; 
/* this is last record set pointer to null */ 
RR. o6 

current->string = malloc(lent); 

make space for data and set pointer */ 


void qet out () 
{ 
exit (0); 


) 


int menu () 


{ 


mnt val; 

char let; 

puts("Add new entries to list ............ <I> Xn"); 
puts("List entries in iste E Oodogono «P» WYJ)B 
puts("Exit this program si .39*49:5:5]9:5] EL 22 B ND DIA 
puts("\nPlease make your ‘selection "); 


let = NULL; 


while( let < «20 ii lette» 3 
let = getch(); 


val = let = *'0'; 


return (val); 


) 


This is not a very sophisticated program but it does show the basics of putting together 
a linked list type of data structure. 


Such a program could easily be expanded to include facilities to insert or delete 
elemenis from the middle of the list. Think about what would be needed to delete a 
record. 


Find Element 
Find out which element it points to. 
Find out which element points to it. 


Make the element which points to it, now point to next. 
Release memory used. > 


The following fragment of code can be used when you know the number of the element 
you want to delete: 


int delete ( int num ) 


record *current, last; 


int i; 
current = start; 


yer 
» 


| if ( num == 1 ) /* first record to be deleted */ 


start - current-»next; 


m 
B —— 
free(current-»string; /* release data memory */ 
free (current) /* release structure mem */ 
) 
else 
{ 
feye(( 3L — Hg al num; LEE) 
( 
last = current; 
current = current-»next; 
} 
last->next = current-»next; 


free (current->string) ; 
free(current); 


POINTER TO 
LAST ENTRY 


POINTER TO 
LAST ENTRY 


POINTER TO 
NEXT ENTRY 


POINTER TO 
LAST ENTRY 


POINTER TO 
NEXT ENTRY 


Adjust the simple list program to add this, then try writing your own routine to insert 
an entry at a specific spot. 


One of the difficulties with one way linked lists is that you are constantly having to 
keep track of where the last record is if you want to do anything more than just add 
onto the end. If this information was included in the element, life would be simples; 
especially when it comes to sorting data. 


This is what is done in the two way linked list. Figure 20.2 shows how it works. 
Each element contains two pointers: one which points to the next element, and one 
which points to the last. Having this information can make complex data moving 
operations much easier. 


The telephone number program shown in Program 088 uses a two way linked list 
together with a basic search system. 
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* Program 088 x 
* Two way linked list v 
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#include <stdio.h> 
finclude <alloc.h> 


#define TRUE 1 
#define FALSE 0 


#define CLS printf ("%c(2J", 27) /*ANSI sequence to clear screen*/ 


TER II KICK IE eR ie hk He ok o IR Ke D KK OK DR K REA EEEE 


* Define structure type to hold entry data iK 
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typedef struct a ( ^ 
struct a *next; /* Next Entry in List */ 
struct a *last; /* Last Entry in List */ 
char name[30]; /* Name Entry */ 
char nums[30]; /* String to hold number */ 


) entry type; 


[Ek A 8k CK kk OR IEEE ES SIO Wk KR A A GER OR E Gk a 
e Globals E. 
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char filename(] = "Telnums.dat"; 


*start entry, 


entry tYPe "last entry, *current; 


t edit flag,entries; 


in 


2a 


m ae cae 


FILE *fp; 


main() 
{ 
int select; 


edit flag = FALSE; 
entries = 0; 


load file(); 


while ( select - menu() ) 
{ 
switch ( select ) 
{ 


case 1: 
view(); 
break; 
case 2: 
add(); 
break; 
case 3: 
search(); 
break; 
) 


) 


if ( edit flag ) save file(); 


" [RK HH IK TTT KT TOT TK TKK KK IO KK Kk kk 
d file() opens a the data file. If no file 
present it checks to see if one should be * 
If not the program is exited. * 


char name buf[30], num buf(30]; 


( filename, "r");  /* Open file to read */ 


e 


annot be opened. 


x, 


Z 


new file, Y / N 25) 
— rg 
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/* Negative response. Do not proceed */ 


entries = 0; 
return; 


~ 
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/* File is opened, read file. */ 


while ( fgets( name_buf, 30, fp ) != NULL ) 
{ 


gun 


fgets( num buf, 30, fp ); 

current = malloc( sizeof( entry ) ): 
strcpy( current-»name, name buf ); 
strcpy( current-»nums, num buf ); 


if ( entries == 0 ) 

( 
start entry ^ current; 
current->last = 0; 
currenc-»next = 0; 
‘last_entry = current; 


else 


current->last = last entry; 
last_entry->next = current; 
current->next = 0; 
last_entry = current; 


entries*t; 
y 


fclose( fp ); 
| ) $ 
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x menu() displays a menu and obtains a choice. * 


* This is returned to the calling function. * 
hhkkk wkk CC GOI IDI CCCII OU e 7 


int menu() 


( 
int select; 


char let = :0; 


CLS; 


puts("Please select one 
puts ("\n\n\tView Conten SG ithestonioving 


puts("\n\n\tAdd entries 


ts of File..... 1 
to SHOTS 2 x 


puts("\n\n\tSearch for entry in File.. 3 "); 
puts("\n\n\tExit from program......... O0 "); 


vnem ece oec Let > '3' ) ) 
( 
let = getch(); 


} 
meturny (let. — 40 »)); 


ITI III SIO IO OK Kk 


* ok() returns either TRUE of FALSE according to* 
* whether the Y or N key is pressed. * 


g NCC CK CC NO RR ROC CRGO OC ROC OK CC KO IOI e ee eJ 


p» int ok() 
( 
char let; 


while( TRUE ) 
{ 
let = toupper(getch()); 


if( let == 'Y' ) return ( TRUE ); 
else 
if ( let -- 'N' ) return ( FALSE ); 


RENE LL cerne een 


view() displays the file starting at the first * 
* entry. Movement through the file is by press- * 
_* F for forward, B for back. Records may be * 

deleted by pressing D. X to exit. * 
zu 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk I IOI I ICI 
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printf("  «B»ack, <F>orward, «D»elete,  e«X»it "); 


while( TRUE ) 
( 


let = toupper(getch()); 


DU FESS 


CONRGG OSE 


if( let == 'F' && current->next.!= 0 ) 
{ 

current = current->next; 

count** 

break; 


FSET EES Eo 7 7 


ee 


if( let == 'B' && cvrrent-»last != ( y 
( 

current = current-»last; 

count--; 


break; 


if( let == 'D' ) 


( 
puts( "Confirm Deiete this entry Y/N" ); 


if ( ok() == TRUE ) 


( 
prev entry = current-»last; 


prev entry-»next-current-»next; 
prev entry = current-»next; 
prev entry-»last = current »last; 
free( current ); 


current - start entry; 
count = 0; 
entries--; : 
f edit_flag = TRUE; 
break; i 


( let == 'X' ) return; 


SEL ane RRA OR KR ANI CORN, RNR A ke Wha WW eic Re 
) adds an entry to the list. * 
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p. 


add() 
char name buf(30],num buf(30]; 
l current = malloc( sizeof(entry type) ); 


while( TRUE ) 

( 
CLS; 
printf("\n\n\tEnter name Hh rg 
gets(name buf); 
printf("\n\n\tEnter number:"); 
gets(num buf); 


printf ("\n\n\t Confirm Entry :\n"); 
printf ("\t%s\n",name_buf) ; 
printf ("\t%s\n",num_buf) ; 


if ( ok() ) break; 
) 
strcpy( current-»name, name buf); 
strcpy( current-»nums, num ouf); 


if ( entries == 0 ) 


{ 
start_entry = current; 
last_entry = current; 
current->next = 0; 
current->last = 0; 

) 

else 

{ 


last entry-»next = current; 
current->next = 0; 
a current-»last = last entry; 
Ti" last entry - current; 


out a searc of the list for * 
| can 2 on either * 
j * 


XO OX Re 7 
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- search() 
{ 
char object[30], let; 
E CLS; 
printf("Enter .pattern to be searched for : "); 
gets( object ); 
current = start entry; 
do 
( 
if ( strstr(current-»name,object) 
|| strstr(current-»nums,object) ) 
( 
CLS; 
printf ("\n\n\t%s\n", current-»name); 
printf ("\n\n\t%s\n", current-»nums); 
printf ("\n\n\n"); 
printf("Press «C» to continue, or «X» to exit."); 
while( TRUE ) 
( 
let = toupper( getch() ); 
if ( let == 'X' ) return; 
if ( let == 'C' ) break; 
) : 
) 
current = current-»next; 
) while ( current ); 
i 
i ) 
i 
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* save file() saves the file if edit flag is set. * 
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save file() 


{ 
if ( edit_flag == 0 ) return; 


/* Data has not be changed so do not save. */ 


CLS; 
puts("\n\tData has been amended."); 
puts ("NnNtConfirm you want new data saved, Y/ 


"airs 


if ( ok() == 0 ) return; 
/* Not ok to save, return to 


= fopen( 


"ec 


—— —— 


current = start entry;  /* set to start of list. */ 


while( current ) 


( 


fprintf(fp,"%s\n%ts\n",current->name, current-»nums); 
/* Newline added for fgets() on load. */ 


current - current-»next; 
) 


fclose( fp); 
) 


Program 088 is a simple demonstration of a two way linked list. In the view() 
function, movement is made through the list by using the pointers to the next or 
previous element in the list. 


The structure for the list is defined as a type with the typedef of entry type. This isa 
structure which contains two pointers to structures of its own type. One of these is 
used to point back to the previous entry in the list and the other to point forward to the 
next entry in the list. To keep track of the list three pieces of information are required: 
the start of the list, the end of the list, and the current position in the list. For this 
reason three global pointers of type entry type are declared, start. entry, last. entry and 
current. 


The function main() is quite simple, being a basic controlling function making use of a 
selection generated in a menu() function. This should present no problems to your 
understanding. 


The list itself is constructed in two functions, load file() and add(). Of these load file() 
is the first called when the program is run. A call is made to open the file in read only 
mode. If this is successful a non-zero value will be returned to the file pointer fp. A 
test is, therefore, made to see if fp is equal to zero. This would mean that the file 
cannot be opened. A check is made to see if you want to start a new file. 


If the file can be opened, it is read into memory, with the linked list being constructed, 
Notice that if the variable entries has the value zero, then you are dealing with the first 
element in the list. In such a case start. entry is set to current. As each entry is made 
in the list the pointer current- >last is made to point to the previous entry in the list, 
whilst current->next is set to zero, as the current entry will be the last entry in the list. 


^c : i ill not be a file to i 
Of course, the first time the program is run there wi read in. In such 
. cases the whole list will be constructed in the function add(). So here, again, you use 


. the test to see if the entry is the first entry in the list. The setting of the pointers 
- follows the pattern used in load fileQ. 
negi dr " 


aa. 


7 


~~ 


Use of these forward and backward looking pointers is demonstrated in the function 
view(). Here you move forward or back through the file by reading the pointers. One 
point to note is that the delete procedure in this function does not work properly. If 
you delete the first or last element in the list it will leave the pointers start. entry and 
last entry, pointing at the wrong values. You should try and write your own additions 
to the code to correct this. 


It is possible to have more than two links to a data element in a list. Three ways is 
not uncommon. In such lists you have pointers which point to the records on each side 
of the element and a pointer which points to another list containing data related to that 
element. This type of structure is often used when you have a secondary list in respect 
to data elements. You can have this structure also in one way linked lists. 


In the program CROSSREF our main list is of occurrences of identifiers used in a C 
program. The secondary lists are of line numbers where these occur. This gives us a 
one way linked list, which points to another set of one-way linked lists. 
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* Crossref.c x 


* * 


* 


* M. Larner & N. G. Backhurst 


* * 


* The program reads a C source file and extracts* 
* a list of all variable names, function names  * 


* and occurrences. These are then sorted and a * 


* print out made giving occurrence. * 
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include <stdio.h> 
#finclude <stdlib.h> 
finclude <ctype.h> 


[III ICICI III IORI IOI IIIT Ke 


* definitions x 
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define 7 ^ DQUOTE put 
#define SQUOTE TV 
#define SLASH AD 
#define ASTERISK Vn 
#tdefine EQUALS o 

idefine FALSE t 

idefine TRUE 1 
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define 255 
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E Type Defs * 
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typedef struct a { 
| char *prog line; /* program line */ 
i struct a *next; /* next line */ 
) program type; 


typedef struct b { 
int line num; 
struct b *link; /* link to next entry ' 
) occur type, *occur ptr; 


typedef struct c ( 
char  *token; /* pointer to token */ 
occur ptr line list; /* list 
of line numbers */ 
struct c *next; 
) token type, *token ptr; 
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token type *start token; 
program type *start prog; 
int comment flag, line number; 


main( int argc, char *argv(] ) 
{ 

WE N ALO S 12) 

{ 


puts ("Usage : crossref < sourcefile >"); 
exit (0); 
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read file( char *filename ) 

( 
FILE *fp; | 
program_type *current_line, *last_line; 
char buf[MAXSTRLEN], *tmp; 


fp = fopen( filename, "r" ); 


puts("Cannot open input file to read."); 
exit (0); 


start prog = 0; 


while ( ( fgets‘ buf,MAXSTRLEN, fp )) != NULL ) 
( 


current line - malloc( sizeof ( program type ) ); 
if ( start prog == 0 ) 

start prog - current line; 
else 


last line-»next - current line; 
current line-»next = 0; 
tmp = malloc( strlen( buf ) + 1 ); 
strcpy( tmp, buf ); 
current line-»prog line = tmp; 
last line - current line; 
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* process file searches file for tokens and places* 
* them in the token list. a 
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process_file() 1 


: ( 
program type *current, *last; 


char buf (MAXSTRLEN]; 


» start token = 0; 
| eomment flag = 0; 
current - Start prog; 


line number - 1; 


x puts("Start Processing"); 

while ( current != 0 ) 

{ 

Ta strcpy ( buf, current->prog_line ); 
" get token( buf ); 

last = current; 


current = last->next; 
line_number++; 
) 
puts("End Processing"); 
sort(); 
results(); 
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* get token reads the in memory file line by * 
* line checking each word. If a valid word is * 
* not inside comments or string delimitors * 
xit is entered as an occurrence in the entry * 
ARRS C x 
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|J get token( char buf[] ) 
char word[MAXWORDSIZE],let; 
int num,cur char,q flag,sq flag; 

E 

cur char - num - q flag - sq flag - O0; 
M e. 

E 
i printf ("03d > %s",line_number, buf) ; 
io e ( buf[ cur char ] != 0 ) 


let = buf( cur char ]; 
D P SE um, 
if ( comment flag ) 


K + 
( T 
E sap 


(i) a 


TERISK && buf [ cur char +1] == SLASH 


( let == AS 
/ comment flag = FALSE; 


ea 


comme 
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if ( let == DQUOTE ) 
q_flag = FALSE; a 

cur chart*; j 
continue; i 
j 


VENS a Erag i 
( m" 
if ( let == SQUOTE ) m 
sq flag - FALSE; 

cur char*t*; 


continue; 


if ( valid first Mlet (vers D 
( 
while ( check let( let ) ) 
{ 
word[num**] = let; 
let = buf[ -**cur char]; 
) 
word([num] =0; 
place_entry (word); 
num = 0; 


if ( let == SLASH  && buf[ cur char + 1 ) == ASTERISK ) 


comment flag = TRUE; 


if ( let == DQUOTE && sq flag == FALSE ) 


q_flag = TRUE; 


( let 


== SQUOTE  && q flag == FALSE ) - 


sq flag = TRUE; 
) 


cur chart*t*; 
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* valid first let checks to see if the a 


* character is one which can be the valid first * 


* letter of a C token. * 
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- valid first let( char let ) 


{ 
return ( ( isalpha( let) || let == ' ' ) ? TRUE : FALSE ); 
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* check let checks to see that a character in a * 
* token is a valid character for a C token. * 
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check let( char let ) 


{ 
return ( ( isalnum( let ) || let 


- 
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* place entry makes an entry for the occurrence * 
* of the token in the list. Vie tes Ehe first * 
* time the word has occurred a new entry is made.* 
* If not an addition is made to the line number  * 
* list. * 
* 
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ce entry( char word[] ) 


token type *this token, *last token; 


occur type *this entry, *last entry; 
~ 


= start_token; 


this entry-»link = 0; 
this token-»next = 0; 
start token - this token; 


return; 
) 
while ( this token != 0 ) 
( 
if ( ! strcmp( this token-»5token, word )) 


( 
this entry = this token-?line list; 


while( this entry != 0 ) 
( ’ 
last_entry = this_entry; 
this entry = last entry-»link; 
) 
this entry - malloc( sizeof( occur type ) ); 
this entry-»line num - line number; 
this entry-»link = 0; 
last entry-»link = this entry; 


return; 


last token = this token; 
this token = last token-»next; 


this token - malloc( sizeof( token type )); 
this token-»token' = malloc( strlen( word ) ); 
strcpy( this token-»token, word ); 

this entry - malloc( sizeof( occur type )); 
this token-»line list = this entry; 4 
this entry-»line num = line number; 

this entry-»link - 0; 

this token-»next = 0; 

last token-»next - this token; 


) 
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* results displays each occurrence of a word in * 
* the program context. A 


y ROR RE RE RO x 
X X XO FORO UN GR RO KG ORA / 


results O 
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program t,pe *current, *last; 
token type *this token, *last token; 


occur type *this entry, *last entry; 
int i; 

$3 

4 this token = start token; 


while( this token ) 


2$ ( 


printf("\n\n\n—-— $s —---\n\n",this_token->token) ; 
this entry = this token-»line list; 


do 


current - start prog; 

for( i = 1; i < this entry-»line num;i** ) 
{ 

last = current; 

current = last->next; 


} 
printf ("%03d > $s",this entry-»line num, current-»prog line); 
last entry = this_entry; 


this entry = last_entry->link; 
)while( this entry ); 
last token - this token; 
this token - last token-»next; 


din. de 


| token, *next token,*ex token; 


t; 


token type ) ); 


this token - start token; 
next token - this token-»next; 


while ( next token ) 
( 
test = strcmp( this token-^token, next token-»token ); 


if. ( testi» M00) 


( 
ex token-»token - this token-»token; 
ex token-»line list = this token-»line list; 


this token-»token = next token-»token; 
this token->line list = next _token->line list; 


next_token->token = ex Loken-»token; 
next tokenline list = ex token-»line list; 


sort flag - TRUE; 
) 


this token - next token; 
next token - this token-»next; ’ 
) 
) while ( sort flag ); 


At first sight this program may appear complicated, but if you break it down it is not 
nearly as bad. There are two separate linked list structures in this program. The first is 
a simple one consisting of a list containing the lines of a C program which has been 
read into memory. The second is more complicated. Figure 20.3 shows what we have. 


You will notice that there is a one way linked list of structures. These structures are of 
a type which contains a pointer to a C token and a pointer to a secondary linked list. 
This secondary linked list is made up of structures which contain the linc number of an 
occurrence of a C token and the pointer to the next occurrence. 

Exactly what this program does is explained below, followed by an in-depth look at oa 
each section. The program reads an input file which isa C source file. This is then — 
processed to extract from it a list of all valid C tokens in input file. A C token is " 


l either a command or an identifier. A record is kept of each occurrence of a token anda 
4 list of such occurrences is produced for you at the end. and E: 


tput of this program can be seen i A ; 
= et analyse how it works. in Chapter 25 on Debugging, but at present 


$ MAIN LIST SECONDARY LISTS 
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We start with the include files. Three files are used: the standard staio.h together with 
stdlib.h because we are using the memory allocation command malloc, and ctype.h to 
provide the type testing macros isalpha and isalnum. This is followed by the defines 
which are fairly normal. One point to note is the use of the backslasn in the definition 
of SQUOTE. This is used to escape the special meaning of the single quote sign. 


We next come to the definition of some types. This is where the basic structures of 
your linked list are defined. 


The first one is a definition of a type program type. This provides the base for the list 
to hold the program lines. The structure consists of two elements. The first is a 
pointer of type character which you will use to point to the string held in memory. 
The second is a pointer to a structure of its own type which will be used to point to the 
next element in your list. 


The second definition is of a structure to hold the occurrences of a token. Here you 
have an integer to hold the line number and a pointer to the next structure in the list. 


Our final type definition is again of a structure to hold each unique token found. There 
are three elements to this structure. First, a pointer to a string where the token itself is 
stored. Then there is a pointer to a list composed of the structures occur type. This 
will therefore be the list of line numbers. Finally, there is a pointer to the next 
Structure in the list. 


There are four variables which are declared as global. These are the pointer to the first 
element in the token list, and a pointer to the first element in the program list. There 
is also a flag to indicate the status of a comment and a variable holding the current line 
number. 


Nearly every function will need to know either the location of the start of the program 
list or the token list, and often both. It makes a great deal of sense to declare these as 
‘global. To do otherwise would have required a great deal of parameter passing. 


It would have been possible to handle the comment flag and line number variable as 
locals without too much difficulty. However, having them as globals makes life much 
easier. It also opens the way for a couple of extensions of the program. 


The function main() is short. You should be able to follow what it is doing with no 
difficulty. 


Read file is the first of the 'working' functions, It opens th i 
soit command line argument and copies the c E ha: His no ee 


though that no check is made to see that the fil 
mig 


ontents of that file into memory. Note 


f like to add this to the function, € Is actually a C source code file. You 
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, Before any reading is done start, prog is set to zero. You then enter a while loop. This 
loop is controlled by the return value of the fgets(), which is reading a string from the 
file pointed to by fp, into a buffer buf up to a maximum of MAXSTRLEN characters. 
If the end of a file is reached, fgets() will return NULL. So our test is while fgets() is 

E not equal to NULL. 


The first task we have to do is grab a block of memory to put our list structure into. 
This is done in the line: 


current_line = malloc( .sizeof ( program_type ) ); 

Next, we have to test to see if this is the first entry in the list. If it is, start. prog will 
be equal to zero. In this case we make the start_prog pointer point to the current_line 
with: 

start_prog = current_line; 

If the start_prog pointer is not equal to zero it means that there are already lines in the 


list. In this case we have to make the last entry point to the current line. This is done 
with: 


last_line->next = current_line; 


Once this stage has been completed we have a list element which has been linked into 
the list. Now we have to set the current entry in the list to indicate that this is the last 
entry so far. This is done with: 


current line-»next = 0; 


ef -. Our next problem is to link the program line into the list element. This is done in two 
|. Stages.’ First, we have to put the program line into an area of memory which has been 
. grabbed. To do this we first have to grab a block of memory. 


tmp = malloc( strlen(buf) + 1 ); 
2 grabs our block of memory. Notice that we have had to use strlen(buf) 1. The 
/— reason for this is that strlen() does not count the terminating zero of the string, only the 
il ters in the string. You have to add one to allow space for the zero. 
o p 


[3 ; r 
grabbe« Ui ed into that memo ith 

g grabbed the memory to hold the string, it is now moved into nemory wi 

DyO function and the pointer in the list structure linked with it. This is done in: 


Timi 


a es oH ED P 


We have now added a new element to the list and linked a memory buffer containing a 
program line to that element. Before we can go on to make the next entry we have to 
make a new last entry, which will be the current entry. This is done with: 


last line - current line; 


At that point the process can be repeated adding more and more elements until the file 
is read. 


The next function in the program is the process file() function. You will find this 
fairly easy to follow. It works its way through the program line list passing each line 
to the get token() function. When all lines have been processed the sort() function is 
called to put the tokens into alphabetical order and the results() function is called to 
output the resulting lists. 


In the next function get. token() most of the work is done, and you should study this 
function with care. There is nothing particularly complicated in it, but there are a few 
points which should be noted. 


First, the flags q flag and sq flag are for string elements contained within quotes or 
single quotes and defined in this function. The flag for comments, comment, flag, is 
global and set to zero in process file(). The reason for this is quite simple. You can 
have a comment which spreads over a number of lines. Any quoted string must be 
terminated within the line, otherwise the compiler will not accept the code. Therefore, 
you do not-have to allow for strings covering more than one line of code. 


The calls to valid first let and check, let are quite simple. If a token is not being 
processed and the letter is a valid first letter of a token, then the process goes into a 
loop reading the other letters of the token until a letter is found which is not a valid 
token element. 


There is a weak point here in that the version of the code given here does not allow for 
the -> and . symbols in structures. Therefore, current.name and current->next would 
be processed as the tokens current, name and next. You might like to look at ways of 
amending the code to get round this. 


At first sight the function place entry() can look offputting. In fact, it is relatively 
simple. The first if test is to see if this is the first entry in the list. If it is, the start of 
a new list is created and a return is made to the calling function. If it is not, we then 
go onto the while loop which is nothing more than a search through the current list to 
find if there is a match. 


It is useful to note here that the test is made using the not operator '!’. stremp() will 
return a zero if both strings are the same, that is, if a match has been found. We are 
therefore, interested in the operation being carried out only if the value is zero This 
could also have been written, and the code might have been easier to read. as: 


( strcmp! this_token->token, word ) 


==. 0 ) 


if 
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If a match is made, that means the token already exists in the list so the current line 
number is added to the list of line numbers for that token. We then return to the 


calling process. 


If no match is made, then a new entry has to be created before the function is terminated 
and return made to the calling process. 


The results() function is fairly simple. We work our way through the token list, 
printing out each token. After each token has been printed we work our way through 
the iine list for that token, each line being printed to show the context of the token's 
occurrence. 


The final function is sort(). This is a very simple bubble sort but quick enough. It is 
in sorting that the use of pointers can do much work. All that is necessary here to 
change the position of a token in the list is to swap four pointers. This is much easier 
than the copying and swapping of strings and array elements which would have been 
necessary in other languages. 


This program is used in Chapter 25 on debugging. Although a very useful tool, it 
could do with some improvements. One which might be worth considering is the way 
we have to do a for loop to find the line in the program list to print it out in the 
result() function. Would it not be better to keep both the line number and a pointer to 
that line in the program list, within the line occurrence list? This is something you 
might like to have a go at adding yourself. 
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LOW LEVEL INTERFACE 


No matter how powerful a language is there are times when you want to deal directly 
with the system. You need to be able to address the system at a lower level. 


Turbo C supports three ways of gaining access to the low level functions of the 
System. These are pseudo-variables, in- line assembly, and the interrupt functions. 


LM 


Essentially, these subjects are for advanced programming, so we do not go into any 
depth in this chapter. Also, everything in the chapter is specific to Turbo C. 


DOS and BIOS Calls 


It is possible to access various facilities on your system by directly instructing the 
hardware to carry out certain actions. This is not generally advisable as any software 
written making use of hardware specific functions will work only on the system for 
which it was written. Even when you are dealing with PC compatibles, they are only 
compatible at the operating system level and often differ considerably when it comes to 
the hardware. 


Under MSDOS and PCDOS there is an interface to the hardware which is constant, and 
of which we can make use. This consists of two parts: the Disk Operating System 
(DOS) and the BIOS, which handles the interface to the hardware. 


DOS and BIOS offer to us a number of services which we can use to manipulate the 
system. These services are invoked by sending a software generated interrupt signal to 
the system. Then, according to the instructions within the system, certain actions will 
be carried out. 


Details of the DOS and BIOS calls can be found in the MSDOS Technical Reference 
Manual and Norton's Programmer's Guide to the IBM PC. If you are thinking of 
making usc of DOS and BIOS calls I recommend that you obtain both these books. 


make a call to any of the DOS or BI 


When you " 3 au OS services, i 
of information to that service. This information is_pass BEM E es ‘of 
ne service oy way Ol 
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stack segment 
pointer f 


processor registers. If you do not know what processor registers are, you probably 
should not be trying to work your way through this chapter. 


Essentially, a processor register is a special area in the microprocessor which is used by 
the microprocessor to store values which it is manipulating. Most of these registers 
have special uses, but many can also be used for general purposes. The general purpose 
registers are the four pairs AX, BX, CX, and DX. Figure 21.1 shows thesé registers: 


AX PAIR 
BX PAIR 
CX PAIR 
DX PAIR 


code segment 
pointer — 


data segment 
pointer vec TREO 


16 bits CS 
16 bits 


DS 
16 bits SS 
16 bits SP 

SI 


STACK POINTER 
BASE POINTER 


extra segment 


pointer 16 bits SOURCE INDEX 
16 bits DI DESTINATION INDEX 
Figure 21.1 


As you can see, each of these registers is made up of two registers: a low register and a 
high register, so in the case of AX we have the pair AH and AL. Tr addition to the 
eight regist lake up the X pairs shown above, there are another eight 
eight registers which make up the X pairs show y other eig 
registers which are‘used for specific purposes. 


If we want to make use of a DOS or BIOS call we have to put some values into the 
e ar aren SS IDIOT 

registers and then send an interrupt signal to the system. 

DNAS oe alle icc M tiii iain A 


Turbo C provides several ways in which you can do this, and some actions are so 


common that it provides library functions to deal with those specific Cases so you do 
not need to worry about all the fiddling about with loading values into registers and 
generating interrupts. An example of this would be absread() and abswrite() which 


make calls to DOS interrupts, but you need no knowledge of these to make use of the 


218 


CC-0. Gurukul Kangri University Haridwar Collection. Digitized by S3 Foundation USA 


P: DODE on, 


functions. However, Turbo ù «oes give you a direct way of manipulating the register 
contents. 


Pseudo-variables 


Turbo C supports a set of identifiers which correspond to the registers of the 
processors. These are known as the pseudo- variables. AC ONE 


You can make use of these variables just as if they were a normal variable of type 
unsigned int or char. The difference is that if you assign a value to one of these 
variables it will be put into the associated register in the processor. Note an important 
point here: do not expect to put a value into a pseudo-variable then come back later in _ 
the program and use that value. The registers are used by the processor and their 
contents are changing. The values given by the pseudo-variables are those currently in 
the associated registers. 


Another important point is the type of a pseudo-variable. The registers are made up of 

two types: the sixteen bit registers: AX, BX, CX, DX, CS, SS, ES, SP, BP, DI, SI 

and the eight bit registers: AL, AH, BL, BH, CL, CH, DL and DH. As an integer. 
takes up sixteen bits, the sixteen bit registers are of type int. The eight bit registers are 

of type char as this only takes eight bits. — — ANDA 707 
The pseudo-variables have the same identifier as the register to which it refers but 

preceded by an underscore. . So if you wanted to load the value 10 into the register AL 

you would use: 


A complete list of the pseudo-variables, their type and size is given in Table 21.1. 


How can we make use of this? Let us consider a fairly simple example, that of drawing 
a line in graphics mode on the screen. Access to the video can be obtained through a 
set of BIOS services known as the BIOS Video Services. These are invoked by giving 


an interrupt 16 ( Hex 10). 


To be able to draw a line on the screen we need to complete two tasks. First, set the 
computer into graphics mode, then plot a series of pixels on the screen. 


The PC supports pee of video modes, for more details see the Programmer's | 
Guide to the IBM PC. "36 one we will be using is the medium resolution graphics 
mode 4, This will give us a graphics screen of 320 x 200 pixels ps 

Coh e zd —————ÓPM Áo Q€ 
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Table 21.1 List of the pseudo-variables 


Identifier Register Size Type 

_AX AX 16 bits unsigned int 
_AL AL 8 bits unsigned char 
_AH AH 8 bits unsigned char 
.BX BX 16 bits unsigned int 
.BL BL 8 bits unsigned char 
. BH BH 8 bits unsigned char 
_CX CX 16 bits unsigned int 
_CL CL 8 bits unsigned char 
_CH CH 8 bits unsigned char 
.DX DX 16 bits unsigned int 
.DL DL 8 bits unsigned char 
. DH DH 8 bits unsigned char 
_CS cS 16 bits unsigned int 
_DS DS 16 bits unsigned int 
.SS SS 16 bits unsigned int 
.ES ES 16 bits unsigned int 
.SP SP 16 bits unsigned int 
.BP BP 16 bits unsigned int 
. DI DI 16 bits unsigned int 
S SI 16 bits unsigned int 


To invoke this mode we have to call up the BIOS Video Services and request service 
zero, Set Video Mode. We also have to tell the service which video mode we want. To 
do this we have to load the number of the service we want into the register AH and the 
mode we want into the register AL. Then we use the Turbo C function geninterrupt() 
to generate interrupt number 16 to invoke the services. So our procedure would be: 


AH = 0; /* Set Video Mode */ 
AL = 4; /* Number of Video Mode wanted */ 


geninterrupt (16);  /* BIOS Video Service */ 


We can therefore write a function called set_video() as follows: 
set video(int i) 

{ 

14s — Of 

TAL =E 
geninterrupt (16); 

} 
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Note that in this case we are passing the value of the video mode we require to the 
function. This makes it more flexible. ii TRE 
— - — 


Now we can set the screen, next we want to draw a line. A line is a series of dots 
joined together, so what we need to do is first plot a single pixel on the screen. Again, 
this can be done using one of the video services, in this case service 12, Write Pixel 
Dot. To do this we have to pass three items to the service, the x co-ordinate of the 
pixel, the y co-ordinate of the pixel and finally the colour. The x co-ordinate is put in 
the register DL, this can never be more than 200 so it can always be stored in an eight 
bit register. The y co-ordinate can go as high as 640 in some graphics modes, so this 
needs to be stored in a sixteen bit register. For this, use is made of the CX register 
pair. Finally, the colour is stored in the AL register with the service request being 
made in the AH. 


Note that service requests are always made in the AH register for all BIOS and DOS 
Services. 


Our routine to piot a single pixel is: 


.AH - service number; 
_AL = colour; 

_DL = x co ordinate; 
.CX = y co ordinate; 


then give the interrupt 16. This is done in the following routine called dot(). To keep 
it simple we are only passing the x and y co-ordinates and having a default colour 
setting of four. You may want to try amending this later so you can send your own 


colour setting to it. 


dot( char x co, int y co) 


AH - 12; 
.AL = 4; 
DL = X CO; 
OS = SEGIOB 


geninterrupt (16); 
) 


As the x co-ordinate is being assigned to an eight bit register, to be on the safe side, we 
are passing this as a character variable. 


As a line is à series of dots, where the plotting Points are amended between each plot, 


this can be d 
each call. LOO 


one by calling dot from within a loop and changing the co-ordinates on 


k at Program 089. 
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* 


* Program 089 


* Drawing a line 
DK OK OQ occ RK AI AAA ic ok oic ico scolcckc coc ecc ec oko oc oko e x kk x x x x / 


* 


#finclude <stdio.h> 
#include <dos.h> 


main() 
{ 
nt iaaa 
i mo SOs 
set video(4); /* set video to graphics mode 4 */ 


SOG (( 3) c 08 3] « SEXO j++ ) 
cx (C oo 39g 


getch() 
) 
B 
set video(int i) 
{ 
für .AH = 0; /* Select service 0, set video mode */ 


_AL = i; /* Select mode required */ 
geninterrupt (16); /* Invoke Bios Video Services */ 


lar x co, int y co) 


Select service 12, write pixel */ 
Select colour required */ 

Set x co-ordinate */ 

Set y co-ordinate */ 


eare plotting a series of pixe 


10 function at the end o oie 


maa ent. 


If you are trying out any graphics, it is sensible to put a getch() at any point where you 


A final point about the above examples is that the programs were originally tried on an 
IBM AT compatible with a colour monitor and colour graphics adapter worked without 
any problems. But when the programs were moved over to another compatible which 
was supposed to have the same configuration, another cólour had to be selected in order 
to obtain any display. So if you find you have problems try changing your colours. 


There is much more which can be done using the pseudo-variables, but it is outside the 
scope of this tutorial. You can use them to find out the status of any register at any 
specific time. An example of this is given in the Turbo C User's Guide in Chapter 9 
on Advanced Programming in Turbo C. = 


In-line Assembly Language 


A feature of Turbo C is that it supports an extensive in-line assembly language. To 
use this you must have a copy of the Microsoft Macro Assembler (MASM) version 3.0 
or later. The reason for this is that when you make use of the in-line assembly 
language, the compiler generates an assembly file, then invokes MASM to produce the 
object file. 


Also to use it you need to have a good knowledge of assembly language and the 8086 
instruction set. 


Given the two facts above the in-line assembly language is well and truly outside the 
scope of this book and we will noi be covering it to any extent here. If you do need 
details about it, you should refer to Chapter 9 of the Turbo C User Guide. 


If you are going to use in-line assembly you must start the compiler with the -B option 
set. See the User Guide for details. 


The keyword asm is used for in-line assembly. This tells the compiler that what is on 
that line is assembly code and will be treated by the compiler as such. The format for 


using asm is: 
asm <opcode> <operands> <; or newline> 


Note that with in-line assembly either a semi-colon or a newline can be used to 
terminate a line of code, so both the following are legal: 


asm movatan i 


al,1; 
asm mov Sa 


You can have more than one assembly instruction on the line: 


asm mov bp,sp; 


foit ded that each entry is ended with a Semi-colon, 
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A word of waming here about the semi-colon. Experienced assembly programmers (and 
if you are going to use in-line assembly you need to be experienced) will be used to 
placing the semi-colon to indicate the start of comments. This is not the case with in- 
line assembly. Comments must be included in the normal C comment fields. This is 


indicated below: 
asm mov anu" /* BIOS Video Service 11 Set Colour */ 


In-line assembly can make use of C variables just like normal C code. Have a look at 
the following version of set, video() : 


void set video( int mode ) 
{ 


ii Mmodem«soN)SH(ES(Emode^» 15 ) } 

return 
asm mov ah,0; /* Service 0, set video mode */ 
asm mov al,mode; /* Load mode selected into al */ 
asm int 16; /* Interrupt 16, video services */ 


) 


For details of the opcodes, string instructions and jump instructions which may be used 
as part of the in-line assembler you should refer to Chapter 9 of the User's Guide. 


The Interrupt Functions */ 


There is a set of functions in Turbo C which allows you to generate interrupts and pass 
data to the processor in the correct registers. These are designed to give you access to 
MSDOS and BIOS calls. 


In the first part of this chapter, under psuedo-variables, we have looked at the simplest 
of these, geninterrupt() which allows us to generate any specific interrupt. 
. ——— mm (—— — 


———— 


"The main one used for giving MSDOS system calls is bdos() or its related function 
bdosptr(), which are covered in the Reference Guide. 

bdos() allows. you to call up directly a MSDOS system call; you can find details of 
such calls in the MSDOS Programmer's Reference Manual. To use them you must 
have a fairly good knowledge of the working of MSDOS. Also, many of the functions 
for which you might want to call MSDOS can be accessed with greater ease through 
one of the special functions provided in the Turbo C library. If you think you need to 
make a direct call to MSDOS (say to read a specific disk sector) have a good read 
through the Turbo C Reference Guide. There you will probably find a function which 


will do what you want, for example, absread(). 
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There are a number of tasks which you cannot do using the existing functions. In 
addition to bdos() there is a set of functions to handle interrupt generation, these all 
start with int and include int86(), int86x(), intdos(), intdosx(), and intr(). We are not 
going to look at all these as they are covered in the Turbo C Reference Guide, but we 
will examine the use of intr() which gives some indication of how to use the others, 
although they mostly work with a union rather than a structure. 


One element that all these functions have in common is that before you can use them 
you must include dos.h in your program. They are all prototyped in that file. It also 
contains the definitions of the structures REGPACK and SREG and the union RES, 
which are used by the interrupt functions, —— Es. 


intr() makes use of the structure REGPACK. This has the following form: 


struct REGPACK 
{ 
unsigned r ax, r bx, r cx, r dx; 
unsigned or bp, r si, r di, r ds, r es, r flags; 


! ` 


When invoked, intr() copies the values held in the structure and loads them into the 
registers, it then issues the required interrupt after which it places the resultant register 
values back into the structure. To do this it needs to be passed two arguments: the first 
is the interrupt value it should issue and the second is the address of the structure, so it 
has the form: — j ET CERE i "m 


void intr( int interrupt value, struct REGPACK *preg ); 


Have a look at how this has been used in Program 090. 


D/ LE Ek kc e cc i oh c ke ke i e e e e kk IKI) TTD KE GEEK ORO RU RO SOR ATE KINDER 


* Program 090 ] 
* Sketch Master a 
eK III IOI AC III IOI AG X f 
#include <dos.h> 

#include <stdio.h> 

#include <ctype.h> 


main() 
{ 


ance c 


char let; 

i t0; V i 

vidset () /* Set video to graphics mode 4 */ 
(2 c AeA /* Set colour to one */ 

i = 100; 
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ee 


j = 160; /* Set x, y, co-ordinates for start 
dot (i,j); /* Start with dot in middle. */ 
while ( 1 ) /* Start endless loop */ 
( 
let - toupper(getch()); /* Get key depression */ 
if( isdigit (1let)) /* test for number key */ 
{ 
c = let - '0'; /* set colour to number */ 
; i eee 
u^ else 
switch (let) 
( 
case 'U': /* UP */ 
iio 
break; 
case 'N'; /* DOWN */ 
- i++; 
break; 
aa case 'H': DEEL GX. 
JE; 
break; 
case 'J': /* RIGHT */ 
j++; 
: break; 
case 'I': /* Right up diag */ 
jt+; 
dog 
break; 
E case 'M': /* Right down diag */ 
i= JEt; 
: T i++; 
PA break; 
case 'B': /* Left down diag */ 
Jh 


i++; 


defaul 
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dot( int x, 
( 


I ) 


E 4 
|». vidset [9] 


T 


if (<0) 32007 
if. ( P 2212009) 919 710; 
if (.3.« 005822320; 
if. ( 3 >, 3201)8 182107 
dot (i, j,c) /* Make dot on screen */ 
int y, int colg) 
struct REGPACK treg; /* Structure for the 
* registers. In dos.h 
v 
int k = Ox0C00; /* Set K with high to 12 and low 
SS 


break; 


/* Take measure for going off screen */ 


* set to 0 
Py 


k += col; /* Add col to k so setting low byte 
* to col; 
A 


treg.r dx = x; /* load dx with column number */ 

treg.r cx - y; /* load cx with row number */ 

treg.r ax = k; /* load ah with service number 0 
* and al with colour, col. 


intr(16,&treg); /* invoke interrupt 16 */ 


struct REGPACK treg; 


treg.r ax = 0x0004; /* Service 0 in high by 
* mode 4 in low y 
*/ " 


intr(16, &treg); 


— 


ES 


This works quite well to give you a way of drawing lines on the screen using the 
U,N,HJJ, Y, I, M,B, keys together with the number keys for the colours. Incidentally, 
you only have four colours. 


The one problem you will have noticed with this is that you can only load values into 
the pair registers, you cannot access AL or AH directly. So, if you need to put a value 
into AH and another into AL it can be complicated. The easiest way to do this is to 
turn the value to be held in the upper register, eg AH into hex, so 10 would be Ox0A, 
then add two zeros to the end. This would give you 0x0A00 which would put the value 
10 into the upper byte. Now assign that to a variable and add the number you want in 
the lower register to it. Provided the second number is below 255 it will go into the 


lower byte of the pair, and you can now assign the value to the double register. 


The Extended Code Keys 


A small matter, but one which can cause problems is the code values returned by some 
of the keys on PCs. You will notice that in the above program example we have used 
the normal alpha keys for movement, not the cursor keys. 


The reason for this is that it was easier to write the program this way. The cursor keys 
return what is known as an extended key code value. This means that they have no 
ASCII value. rae 


Whenever a key is pressed an integer value is returned to the system. If the lower eight 
bits are set then these are the ASCII value of the key pressed. This is taken as a 
normal key value. However, if the lower eight bits are zero, then the key is one of the 
special keys, ie the cursor or function keys. In such cases the upper eight bits contain 
the value. This cannot normally be read directly with the functions like getch(). 


The following code fragment is from a commercial program. It enables you to read the 
value for cursor and function keys. 


read( char *ch ) 


{ 


char a,b; 
AH = 0; /* Load AH with service required. */ 


geninterrupt (0x16); /* Call bios keyboard services */ 


b = AL; /* Read values */ 
a = _AH; 


dE OS (IDEO) 
{ 


*ch = a; 
return ( -1 ); 
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— Ó——— HS. 


m: s 


else 


*ch = b; 
return (0); 


This function is quite useful as it will either return a 0 with the ASCII character placed 
in the character variable pointed to by the argument passed, or it will return -1 with the 
extended code of the key pressed placed in the character variable, in the case of a special 
Key. 


Turbo C also supports a function, bioskey() which gives you direct access to the 
keyboard biosfunction. This is a very powerful function and well worth some study. 
Look it up in the Turbo C Reference Guide. However, although it is a powerful and 
useful function, it does not always behave quite as you would expect. You can have 
some unexpected results from using this call, so treat it with care. 


pem | 
i 
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RAW I/O 


The subject of raw I/O is rather a questionable one when it comes to working under 
most operating systems. C was developed alongside Unix, and under Unix the raw I/O 
routines provide direct access to the Unix operating system I/O handling routines. Asa 
result of this, they generally provide you with a much faster form of file access than 
you have with the normal buffered I/O routines looked at earlier. 


Once you move out of the Unix environment this advantage does not generally apply. 
Practical experience indicates that for most work you can safely leave raw I/O 
operations well and truly alone. As such operations are not without a degree of risk at 
times, this might be an advantage. 


There are times when raw I/O has a role to play. This is especially the case when you 
have to send a value to a file which would normally be considered a terminating value. 


Files to be accessed in a raw I/O mode are opened using either the function open() or 
the | function creat(). . The former is used to open an already existing file, and the latter 
to create and open a new file, or to open an existing file for overwriting. 


The call to the open function takes the form of: 


|. fd = open( pathname, access [,permissions] ); 


(0 where fd is an integer file descriptor, pathname is a pointer to a character string and 
access is an integer value, which is usually expressed in a symbolic form which defines 
type of access to the file. The optional parameter permissions allow variations to 
posed on the type of access. However, there are a number of problems here in 

at they are not supported by versions of MS-DOS below 3. 


en function is prototyped in the header file 'io.h'. This file should be included. 
clude 'fcntl.h'. This is the file which contains the symbolic forms for 


——— a o o 


Table 22.1 The Read/Write flags 
Symbolic Description Hex Value 
O_RDONLY Open for reading only 0x0001; 
O_WRONLY Open for writing only 0x0002; 
O_RDWR Open for reading or writing 0x0004; 

The Access type flags 

Symbolic Description Hex Value 
O_APPEND All writes to append to end. 0x0800 
O_CREAT If file does not exist create 0x0100 

it with the permissions set. 
O TRUNC Truncate file to length O. 0x0200 
O BINARY Open in binary mode. 0x8000 
O TEXT Open in text mode. 0x4000 


There are two additional flags available O NDELAY and O_EXCL which are provided only for Unix 
compatibility and are not used under MSDOS. 


With Turbo C under MSDOS 3.x and higher, there is a set of additional values which 
can be given to cover file locking. They are: 


O. NOINHERIT This means that the file is not to be passed to any child 
program. 


O DENYALL This allows no other access to the file while it is open with the 
current handle. 


_Q_DENY WRITE Wis allows only reads to be done from other file opens to this - 
A ile. bau * 


ENYREAD This allows only writes to be d <a 
O.D file. one from other file opens to this. 


With thi ; uil cd 
o. DENYNONE Ee. is all access rights are allowed to the file by all other 


Ese". 


ugh they are not of much importance for n 
orking, this is changing. With the 


'ormal, single user, sing í i 
arrival of full network support. nder 


MSDOS 4 and the new multi-tasking systems these options are going to be used 
increasingly. 


Another concem with the open() function is its portability. There tends to be a 
variation in the way it works between compilers, especially when code is being moved 
between operating systems. 


To output to a file opened with open() or one of the other calls for raw I/O (create, 
open, dup, dup2 or fcntl) use is made of the function write(). The format for using this 
function is: 


write( file descriptor, buffer, number of bytes ); 


where the file descriptor is an integer value returned by the call which opened the file 
for access, buffer is a pointer to the address of a buffer, and number. of bytes is an 
integer telling the call how many bytes to write from the buffer. 


Write behaves slightly differently according to how the file has been opened. If the file 
has been opened in text mode, that is O TEXT set, a translation will take place of the 
linefeed character to the carriage return and linefeed pair. However, if O BINARY was 
set, no such translation will be made. 


The complementary function to write() 1s read(). The form of this is: 
read( file descriptor, buffer, number of bytes ); 


This will read the number of bytes specified from the file indicated by the 

file descriptor into the buffer pointed to by buffer. Again, there is a difference in 

— operation according to whether a file is opened in text mode or not. If it is in text 

— — — mode read() removes carriage returns as they are read, and it will report any occurrence 
= of the Ctrl-Z character as an end of file. 


Another basic function in this set of raw file access functions is Iseek(). This is to the 
— raw I/O functions what fseek() is to the standard access functions. It allows you to 
= position the pointer within the file. The format for this call is: 
sai. 


E 


-PUSS 
^ lseek( file descriptor, offset, whence ); 


t 


file. descriptor is an integer returned by the call which opens the file. Offset is a 
eger giving the offset to move to and whence is an integer value which 


DT 


function is 
n 


e descriptor ); 
zd dis 


"ed N „m 
? 
T 


= 


0 LL LL 
Table 22.2 The Symbolic values for whence 
Symbolic Name Offset calculated: Value 
SEEK_SET from file beginning 0 
SEEK_CUR from current position 1 
SEEK_END from end-of-file 2 


where offset is a long integer, and file_descriptor is a file handle returned by the 
opening call. The value returned by tell, which in this example is assigned to offset, is 
the current offset of the pointer within the file referred to by file_descriptor. 


The use of the above basic raw I/O with the exception of write() can be seen in 
Program 091. This is a common use for raw I/O, handling a hex dump ofa file. The 
problem here is that if you are looking at a binary input you may well get the Cul-Z 
value as a valid element in the file. With the standard buffered input this would be 
taken as an EOF marker. With the open() set to a binary read this problem is avoided 
using the raw I/O. 


[RO OE RE RR EEE 


* Program 091 i! 


* * 


* Hex Dump of file using raw file I/O calls x 
OXCOKCk X KO ROO ROO ORO EE XX I 


/* Include files */ 


#include <stdio.h> 
include <io.h> 
#include <stdlib.h> 
#include <ctype.h> 
finclude <fcntl.h> 
#finclude <errno.h> 


/* Definitions '*/ 

idefine BUFSIZE 256 
fidefine TRUE ` 
#define PALSE 

J^ code Macros v7 


CLS printf("$c[2g« 227 

efine E ye 

E. PUTECUR ox v Printfi"Ae[Agraqga 27 y y) ~ 
(A, e p 


TX 
- 


E. 


= 
A; 
/* Globals E, 
long offset; 
int file des; 
P char buf [BUFSIZE]; 
main( int argc, char *argv[] ) 
( 
ifo Margcues 22) /* Not enough arguments */ 
v ( 
puts ("Usage fdump « filename »"); 
exit (0); 
E ) 
file open( argv[1] ); 
file show(); 
s ) 


[RR RR RK IO OO RO žk k*k 


* file open, opens a file using raw I/O access 2 


* ir the case of an error the program is exited  * 
FOR III OO kk kc Ok OIN IT TOTTI KOI ORCI OC OO TOI TOK IOI kk kf 


file open( char *filename ) 


oe 


int access; 


access =-O RDONLY | O BINARY; /* Set access to read only in 
* pinary file mode. 
"y 


file des - open( filename, access ); 
if ( file des < 0 ) /* Error opening file */ 


switch ( errno ) /* Reports error */ 
( 
case ENOENT: 
puts("Path or file name not found"); 
break; 
case EMFILE: 
| puts("Too many open files."); 


case EINVAC 
puts( 


(a 


puts ("Unspecified file access failure."); 
) 


puts("Unable to open file. Exiting."); 
exit(0); 


[RRR RRR RR RK RRR RK RK KK KERR EERE KR 


* file show displays the contents of the file ^ 
* on screen using hex and ascii. The file is v i ! 
* read into a buffer with file read and movement* 
* forward or back is done with file move. * | 


WOROROROROR X XX X0 X XX KR REAR EK / 


file show() 
( 
int exit flag; 


exit flag - FALSE; 
offset - 0; 
while ( ! exit flag ) 


( 
file read(); 
screen show(); 


exit flag = file move(); 
) 
) 
J| ROROkOkCk KA Ok Ok OC OK KO ROANOKE RO RU 5 
* file read, reads a buffer from the current * b 
* pointer position and puts it in buf * 


MOROROOK OK RCAOKOWOKCK OK X CA CACROKOR OK OW OKOR AÁ X OW AOK X X XOK X OR X On x X X ox / 


file read () 
{ 


int e num; 
e num = read( file des, buf, BUFSIZE ); 


e num == 0) 


f 
1 


PUT CUR(23,2); 
putsi"At end of file. 


geter; Press key to continue. 


) 


44 4f( e num « 0) 


puts("File reading error 


E APP OR 


* ref. 


ui uf ota: " m 
- 5 sA f ~ 


exit(0); 


JR KK KK RII OI III IOI IOI IOI IO I ESSE! xe eee 


* screen show displays the contents of buf on * 
* the screen. X 


RRR OK kc oc oco oc coc oic ok Koc kc Ok Rc c Kc C kc OR OK kc Kc OK ke ke ee e x xx / 


screen show() 

t 
int ine num, i, j, buf off; 
unsigned char ch; 


line num = offset; 3 | 
CLS; 


Lou = 


{ 

printf("$04x > ",line num); 

for 3) = OF 3) T6 JF) 

{ 
Ian fis c (po os GIG) t j y; 
ch = buf[ buf off ]; 
printf("*02x ",ch); 

printf(" | og 


"ev (( 3 = OF 3) « M95 Shee) 


buf_off = (i * 16) +j; 


= ch = buf( buf off ]; 


= oe 


ji 3 NAHM Th OK B OK ICE IOICIOICIRCOICICICICIEOKO Bel EI RINK INE EAE 


* file move moves the pointer forward or back in* 
* the file according to keys pressed. If'q is * 


* pressed the exit flag is set. * 
KEAN e kk t i e e e e e e e e e e e ok ke coke oko iL ONG OK Ki Ck EMI 


file move () 


{ 
long tmp; 
char key; 


FUT CUR( 24,1 ); 
printf(" F - forward. B - back. Q - exit. "); 


offset = tell( file_des ); /* Get current position of file ptr */ 
while( TRUE ) 
{ 


key = toupper( getch() ); 


switch ( key ) 
( 


case 'F': 
return (0); 
case "BM: 
tmp = 512; 
abe (ER, offset - tmp ) < 0 ) 
break; 
else 
lseek( file des, -tmp, SEEK CUR ) ; : =f 
return (0); * 
case 'Q': ^ 
return (1); 
default: 


) 


Raw I/O can be useful, but is best avoided unless necessary. There are times when it 


‘can be too high a level. If you want to write software to repair damaged disk sectors, a 


much lower level of access is required. te S 


n 
P 


Ems many versions of C this would require you to write yo 5a 
With many. of the MSDOS interrupts 25 and 26 hex. Fannie ee 
aking easier. You are provided with two functions absread 0 ine 
irect access to disk sectors for Teading and writing, Van 


—— . 
absread( drive, number of sectors, sector num, buffer ); 
: where drive is an integer giving the drive number, 0 = A, 1 = B, and so on. The next 
integer nurnber. of sectors gives the number cf sectors to be read. This is followed by 
) an integer giving the sector number from which to start the read, and finally there is a 
=H pointer to a buffer where the data read will be stored. 
H The format for abswrite is basically the same: 


abswrite( drive, number of sectors, sector num, buffer ); 
where buffer contains the data to be written back to the disk. 


; Program 092 gives a basic disk sector editor. It reads a sector and displays the result on 
the screen. You can then edit a sector, either in Hex or ASCII. This is a basic program 
and it is advisable to do some work on it to improve the interface. One suggestion is 
to only display half a buffer at a time and use the side by side display we had in the hex 
dump Program 091. Be careful, though. Direct writing of disk sectors is the easiest 
way to ruin your computer's health. Make sure you are working on a scrap floppy 
disk. Do not try anything on your hard disk, or even with a valuable floppy, until you 
are certain that everything is working as it should. 


[ORO III IOI IOI IO IOI ITO III Ik te 
* Program 092 * 
* * 


Disk sector editor x 


* 

* 

* Warning, use of this program could seriously 
* 

* 


* 
* 
damage your disk data if you are not careful. * 3 
KKK KKK KKK KK KK KKK KK we kk Re / 


a ce E 


/* Include Files x, 


| — #include <stdio.h> 
© #include «stdlib.h» 
ir din <errno.h> 
: «dos.h» 
! <ctype.h> 


a | 
* 


Definitions 


SS 


pomeem eT CUR (x, Y) print£("%c(%d;%dH", 27, x, y) 
/* Globals y 
char sec buf(SECTSIZE]; 


int drive, num of sects, sector; 


nain() 

{ 
warning (); 
get start(); 


pro_buffer(); 


[OR OO OO RRR ERE 
* warning displays a warning about editing disk * 
x 


* sectors. 


OT ITOK III IO OR OO  / 


warning () 


{ 
CLS; 
puts("Editing Disk Sectors can have unexpected results. Do not "); 
puts ("edit a disk sector unless you are certain you know what you "y 
puts("are doing."); 
printf("\n\nDo you want to continue. Y/N ? "); 
fe OK\(;), ) 
return; 
else 
exit (0); 
} 


VAINE Dk Ok e ie t sk ke KK ek ek OK OE CO DK HEX EK DEKOR UR STS 


* ok returns TRUE if Y is pressed and FALSE if .* 
* N is pressed. x 


ORLA RARE c ok eie e kk ke e C kk ke OK KK OK KK OK OR KK ERRA 


int ok O 
{ 


char let; 


while ( TRUE ) 


{ let = toupper( getch() ); 
jf det mm VL 
return (TRUE); 
i5 et mm UNIUS 
return (FALSE); 
) 
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é PERI EEANN EAA A AALAN AELA AEE oic ole e coke cie e eoe e ie eode e ese e oe 
po 
— * get start gets the initial setting for the * 


* drive and sector on which to work. * 
Doc olco KK RK cfc oc coco coc oe e oc o c c c c e kc e c kc e e eoe See e e en e e e ee / 


get start() 
{ 


char let; 
CLS; 


/* Set number of sectors to 1 */ 
num_of_sects = 1; 


/* Obtain disk designation to work on. */ 


g while ( TRUE ) 
- : d | 


» print f("\n\n\tWhich disk do you wish to work on A, B, or C "); 


do 
( 

let - toupper( getch() 
) while ( let « 'A' || let » 


drive - let - 'A'; 


printf("\n\n\tEnter sector to start from. "); 


scanf ("%d",&sector); 


printf ("\n\n\n"); 

printf ("\tDrive = tc\n\n",let); 
printf("\tSector = %d\n\n",sector) ; 
printf("\tIs this correct Y/N ? "); 


ok() ) 
return; 


CLS; 


kok kk kk ek ke 
ntrol loop 
c from the edit 


pro buffer () 


{ 
int exit_flag = FALSE; 


while( ! exit flag ) 
{ 


read_sector(); /* Refresh in memory image | 
* of sector even if loaded 


Nu 

* so that all changes are hi 

* shown. ti 

wf. u 

show .sector(); j i 

: E 

exit flag = edit_sector(y; j ij 

) | i 
" 
j 


/ kki ke eoe he e Ox OO Ok OO OO OO OK OK OO OO OK OO IO KORG OO IO 


re 


* read sector reads the selected sector from the* | 


H * 
* disk into memory. 
OXOK Ok Kk Ok Ok OR KKK REAR Xxx / 


read sector() 
{ il 
if ( absread( drive, num of sects, sector, sec buf ) >= 0) B 
return; E i 
else 3 
7 h 
puts("Error on sector read, exiting. "); E 

exit (0); 1 


TRUE TR Kos e oe oie e kk ROBO RC IRAK UK RO NT SION I IS 


* show sector displays the contents of the * 
* sector on the screen. The top 16 lines are * 
* the sector in hex, the bottom 8 in ASCII. LN E E3— 


3 AK KORR ACAORAOAOAOAOKAOIAOK AURORA OCA AORTA RC A IGI E ER A y) 
**** KR E M 


show sector() 


int line, i, ji 
unsigned char ch; 


t "o MEN O a S2 gtr, linett ) 


i ch = sec buf[ iine ]; 
printf("t02x",ch); 

) 

printf("\n"); 


line = 0; 
fiev. (( 56 op LT 8; i++) 


puma u5sc4x > Vine ); 
for ( j= O07 j < €4; jtt, line++ ) 
{ 
chy ="secubuf[ line ]; 
hitagEn'spuintech- ) ) 
PANER SeN, Ch); 


ee eR XR 


else 
pisunt2fe (1w)77 
) 
! print£("\n"); 
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* edit sector allows the user to select which x 
* form of edit to undertake if required and to  * 
* move forward or back one sector.  Q exits. * 


FOI KC KIKI XXX OK KK IOI IO IO OK CK Ak KK Ak X Kk AO / 


. edit sector() 
E int edit flag, key, key flag; | 
E har. let; 


case 'B': 

if( sector > 0 ) 
sector--; 

key flag - TRUE; 
break; 

case 'H': 
hex edit(); 
edit flag - TRUE; 
key flag = TRUE; 
break; 

case 'A': 
ascii edit(); 
edit flag - TRUE; 
key flag - TRUE; 
break; 

case 'Q': 
key flag = TRUF; 
return ( 1 ); 

default: 


if ( edit flag ) /* If there has been an edit. Save? Slows 
save buf(); 
return (0); 
) 


[III FRI IO RE KK RC ARCOXCOROEORROROR ORCI XOE OK ISIS IR EEE 


* hex edit undertakes the edit of the hex dump. * 


* position is controlled by cursor keys. 
ck X X KO OK X X KO X X X XO A X A X KOX  KOk k ROCK X K E KO ROKCKCO K KO A E X XX f 


* 


hex edit () 
{ : 
char let; 

int line, col, s off, val, exit flag, key; 


s off = 87 /* Allow for o 
* line of he 
T ney 


let = 0; 


puT_CUR(25,1); 
printf ("%c[K", 
X 


PUT CUR(25,1); 


while d "exit flag ) 

inten Cl pos; /* local to loop. */ 
È /* Caiculate values for cursor positioning. 
* you have to allow for the offsets. 


"y 


nine t 
Gl = G gt s ( cen S TR 


x /* Calculate the position in the buffer 
* represented by the cursor. 
^ */ 
mpos = ( line * 32 ) + col; 
PUT CUR(1n,cl); 
key = read key( &let );  /* read key will return 


* if function or cursor key 
* pressed. 


Au 
if ( key ) /* Function or curso key. */ 
{ 
switch ( let ) 
{ 
case 68: 
exit flag = TRUE; 
break; 
case 80: 
linet++; 
if ( line > 15) 
line = 0; 
break; 
case 72: 
line--; 
ale (( thra < @ 7) 
p line = 15; 


break; 
77: 


= Pasar 
coltt; 


=l 


if (col N32 
col = 0; 
break; 
default: 


else /* ASCII key pressed. */ 


if( !isxdigit( let ) ) /|3 "ocke Juve feys v// 
continue; 


/* Take inputted letter 
* and convert to hex num value. 
* Then get next letter of pair. 
s 


int hold, hl, h2; 
let - toupper( let ); 
printf("$c",let); 


if( let >= 'O' es let <= u9un) 
hi = Vete— sO: 
else 
hi = 10 E (Eec E 


while( !isxdigit( let - 
getch() )); 


let = toupper( let ); 
printf("$c",let); 
if ( let >= '0O' ce let <= "9" )) 
nad Gy UON 
else 
h2 = 10 + ( let - 'A' ); ad 


hold = ( hl * 16 ) + n2; tox 
/* Display location and value */ z 3 


PUT_CUR (25,70); Ts 
printf ("%02x $d",hold,pos); | 


/* Move to next po 


colt+t; 


if( col > M T n. 
EC 
Ve 


af(( swa » 048 
line = 0; 


sec buf(pos] = hold; 


RRR ccc I KT RI oe koc Sk kc HICH kc kc oko coke kc ek KI II ke ek ek e e e e 


* ascii edit uses the same basic system as hex  * 
* edit, but the edit is on the ASCII display e 
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ascii edit () 


char let; 

imn nero MESO ROCE, Val, exit flag, key; 
s off = 8; 

off = 17; 

let = 0; 


PUT_CUR(25,1); 
printf ("%c(K",27); /* Erase to end of line */ 


PUT_CUR(25,1); 
printf("Cursor keys to move round screen, F10 to exit."); 
exit_flag = FALSE; 


line = 0; 
col = 0; $ 


x 


exit flag ) 


cl, 


ln, pos; 


line + 1 off; 


if ( key ) 


else 


case 68: 
exit flag - TRUE 
break; 
case 80: 
line**; 
je COLO s T) 
line = 0; 
break; 
case 72: 
line--; 
Be (Cabe « © y 
line = 7; 
break; 
case 75: 
col--; 
LE ( eel « @ )) 
col = 63; 
break; 
case 77: 
colt+t; 
Me (( Gol > G3 )) 
col = O- 
break; 
default: 


if( !isprint (let) ) 
continue; 

printf("$c",let); 

sec buf(pos] = let; 


col*t*; 
aye (( «xo > Gs) )) 
{ 
line++; 
col = 0; 
} 


if ( line > 7 ) 
line = 0; 


| 

| 

| || 

IN 

TE 


1 save buf() 
{ 
n PUT CUR(25,1); 
printf("*c[K",27); /* Clear to end of line */ 
printf("Save Edited Buffer Y/N"); 


if( !ok() ) 
li return; 
i abswrite(drive,num of sects,sector,sec buf); 
4 ) 
t 
| Jf RC OC o e e e ke e e OO kkk kkk kk KKK KKK KKK KK 
i * read key, reads the keyboard using a direct * 
= E tee) COS If a normal key is pressed that * 
* value is passed to the character pointed to e 
i * by the pointer passed and the zero value e 
* is returned. If an extended key is pressed * 
i * the -1 is returned and the key value is passed* 
i CC E Kc CK RC KCN KON KORR CORN ORCI ORO ORCI OCCUR e e e e / 
read key( char *ch ) 
{ 
char a,b; 
_AH = 0; /* Request for service. */ 
geninterrupt (0x16); 
b = AL; 
1 a = AH; 
| A if ( b == 0 ) /* Low bits zero so extended key */ 
* wu ( 
*ch = a; 
j return ( -1 ); 


/* Low bits not zero so ascii key */ 


Use it with care. Itis well 
find out what is possible. Also, 


ng anything but the simplest raw — 
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CONDITIONAL 
COMPILATION 


One of the problems in writing software is that customers are never happy with what 
you have. Usually, they want something slightly different, not much different, justa 
bit. Also, you are liable to find yourself making minor changes to code just to account 
for differences in hardware between systems. 


One aspect of C which can be very useful for dealing with instances like this is 
conditional compilation. This is a set of preprocessor directives which cause certain 
tasks to be done, or not done, at compilation time. 


You already know the preprocessor directives #define and #include. The others you need 
to know to carry out conditional compilation are: 


#ifdef SYMBOL If SYMBOL has been defined the following code is 


included. 

#ifndef SYMBOL If SYMBOL has not been defined the following 
code is included. 

#if (expression) If the expression is true the following code is 
included. 

fendif Conclude the preceding #if, #ifdef or #ifndef. 

felse Else for #ifs. 


gundef SYMBOL Undefine previously defined SYMBOL. 


ditional compilation? : ; 
do we mean by con pi tion? Basicall ; C : 
: jn your code which tells the compiler which code should bere a series of 
E: out. Look at the following example: compiled and which 


| 


#define DEBUG ~ 


#ifdef DEBUG 
puts("At start of code."); 


$endif 


#ifdef DEBUG 
puts("At the end of code."); 


#endif 


Here we have defined DEBUG. When the code is compiled the debug statements will 
be included: Later, when we have found all the bugs we can compile without the debug 
Statements, without having to go through all the code to remove them, just undefine 
DEBUG. 


This sort of usage is fairly common for conditional compilation, especially with 
verbose and non-verbose versions of a program. 


Another interesting use for this is where code is being produced for different countries. 
For example code may be intended for customers in England or in Holland. Most of 
this code is written just for that one program. There are, however, a large number of 
standard routines which can be included. Typical instances are those for Y/N responses. 


There is a difference in Yes/No responses between the two countries. This can be 
overcome with a standard ok() function which includes the printing of the <Y/N>? at 
the end of the query line and which adjusts for country. 


ok () 


{ 
char let,match; 


#ifdef HOLLAND 
printf(" <J/N>-"); 
match = 'J'; —MÀ 
#else s 
printf(" «Y/N» "); 
matches 
fendif 


while ( 1 ) 


. ?, 3 
let = toupper (getch ( ); ud 
[ 
d \ 
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if ( let -- match ) | 
return (1); j 
if ( let == 'N' ) 
return (0); 


) 


With this function if HOLLAND is defined at the start of the program, the J/N will be 
printed, and a yes match made on J, not on Y. 


The use of the #if preprocessor is more complicated. Here, the directive evaluates a 
constant expression which is in the brackets following it. Subsequent inclusion of 
code will depend on the value of that test. If the evaluation results in zero, the test is 
false and the code is skipped. If it is any other value, the test is true and the code is 
included in the compilation. A basic outline example of this is given below: 


$define MESLEN 256 
#if ( MESLEN < 255 ) 

code to include. 
felse 

code to include. 
fendif 
This outline came from a program where two different include files had to be used 
according to the message protocols being employed. The difference between which 
protocol was being used was the size of message they would accept. So the selection 
was made on message length. 
A final important point about the #ifs. Each one must have its own #endif. It does 


riot matter if there are other #ifs in-between, but you must make sure that you have an 
#endif for each. So be careful. 


Defining Out Code. 


: f comments for cutti . X m. 
In Chapter 3, the use o r cutting out code was discussed. This q 
is often used during debugging, especially to make sure that MEC are 
constant. : p ef 


>. 


roblem is that if you have comments i ie 
fen cea i is oe 


[<a ae 
POT mu 
LK L6 E Ss. 


com 


"c H 


to allow comments inside comments. Such use is not considered good practice. 
Furthermore, many debugging tools will not accept nested comments. 


Another way for cutting out a block of code is to use the #ifdef preprocessor directive 
with a default symbol OUT which is not defined. So, to cut out a block of code you 
would use the following technique: 


if( max « 10 ) 
( 


#ifdef OUT 
d printf("\nPlease enter new value for size [default 
10]"); 
scanf("$s" &val); 
max = atoi(val); 
if ( max >= 10 ) 
i return (max); 
$ else à 
P #endif 


return (10); 
u ) 


This is an illustration from a program which required debugging. It was necessary to 
- check that a routine which called the above code fragment was working correctly. To 
do this the value input had to be constant. By defining out the section which allowed 
“the value of max to be varied, its value was set constantly to 10, the default return 
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MODULARITY 


One of the advantages of C which is often put forward is its structured nature. In this, 
it is often compared to Pascal. In this chapter we look at the modular nature of C, how 
you can use this, and some problems it can cause. 


Chapter 1 discussed the basic structure of C and explained that any C program was 
made up of a number of functions. There is one function you have to have: the 
function main(). This is the entry point for the C program. 


In Figure 24.1 you will see a diagrammatic representation of a C program which 
displays the basic modularity found in most programs. 


At the top you have the entry point function main(). In anything larger than a small 
program it is unusual for any processing to take place in main(). Normally, from 
main() you will call a number of control functions which handle different parts of the 
program. Most programs consist of two or more distinct parts which are fairly 
independent of each other in an operational sense, but may be linked by their use of 
common data. 


This can be seen if you consider the example of an interpreter for a Computer Based 
Training language. Here you will have two distinct parts, the program input section and 
the program running section. The following code fragment is from the main () function 
of such a language called L-taal, which shows the way that the control functions for the 
various elements of the language are invoked. 


main() 


{ 
int select; 


current = start = last = (prog line *) 0; 
error = match flag = 0; F i 
return point = stack point = -1; /« muse PAUA nos hese 


* below the empty cell 
add 


Endless Loop */ 


CLS; 
select = menu(); 
switch (select) 
{ 
case 1: 
new(); 
case 2: 
add(); 
break; 
case 3: 
edit(); 
break; 


case 4: 
run(); 
break; 
case 5: 
laiste (0) ge 
break; 
case 6: 
load(); 
break; 
case 7: 
save(); 
break; 
case 8: 
» get out(); 
: break; 
default: 
puts("No valid selection"); 


y 
EU raerror9) 


riables main() enters an endless loop. First, it 
idles the selection of operations. Then, 
the ropriate control function. 


Li 
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ss These process functions often call even lower levels of functions known as operational 
à functions. : The difference between a process function and an operational function is that 
a process function will carry out a number of operations on data, whilst an operational 

function will only carry out one operation. Consider the following code fragments: 


get entry( int offset] 
( 
char let, row, col; 


while ( TRUE ) 
( 
let = getch(); 
if ( isnum( let ) ) 
break; 


row = (offset / 32) + 5; 
col = (offset $ 32) + 10; 


put cur( row, col); 
printf("$c",let); 
buf[ offset] = let; 


his function get_entry() is completing three tasks. It is obtaining a valid entry, then 
culating a display position and displaying it, and finally assigning it. It could be re- 
itten as: 


get_entry(int offset) 
(^ 

hj = buf[offset] = valid entry(); 
| show entry( offset ); 


row = ( offset /32 ) + 5; 
colws ( offset %32 ) 4 10); 


put cur( row, col); 
printf("$c", buf[offset] ); 


In this second set, get entry() is a process function. It is handling the process of 
getting an entry. The two functions valid entry() and show. entry() are operational 
functions. Each is carrying out one of the operations required by get entzy(). Each 
operational function is only doing one clearly defined job. 


This single activity status has two advantages. First, it makes testing and debugging a 
function far easier. For more on this see Chapter 25. Second, as a number of tasks are 
liable to be common to different processes, you can use the same operational function 
to support a number of process functions. 


In fact, some operational functions are so common in programs that you will find 
yourself writing the same function in nearly every program you create. An example of 
this is the put. cur() function called in the above programs. Numerous programs which 
have to access display output on the screen use this function. 


Rather than having to re-write the function every time, it can be included as part of a 
#include file. For example a file called screen.c can contain a series of screen functions 
for common use. These are clear screen, position cursor, and clear to end of line. 


Using the #include preprocessor directive to include standard files like this can have 
major benefits in software development. First, less time has to be taken entering code. 
Once you have typed a set of standard functions, all you need do is include them. 
Second, as they are already tested and working it reduces the amount of debugging 
which has to be done. One reason for this is that it cuts down the chance of a 
typographical error as a function is entered. 


There is a price to pay for a high degree of modularity in a program: that is the 
overhead in calling functions. This was briefly mentioned at the start of this book, but 
a quick recap is worthwhile here. Every time a function is called, a jump has to be 
made to that function. Parameters have to be passed and return locations recorded. All 
this takes ume. 


If you are working in a time sensitive environm 


ent, essenti ime i 
could cause a problem. In such cases yo ally real time progammi 


is u hav i efl 
b ec This may not be a good structured SURE inte io process as:inaling 
matters i$ that the program works, O programming. However, what 


a find that modularity has been carried to 4 any other highly structured language, 


XC A x 2 
ess. Fora start, there is no point is 
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calling a function which itself just contains a single system call. The overhead on 
making such a call is not worthwhile. 


There are two problems with having to write in-line code, where that code fragment has 
to be repeated a number of times. The first is the amount of time taken in entering 
code. The second is that with each entry the chances of a mistake being made are 
increased. 


One way around this is to make use of code macros. Do not be put off by the fact that 
a macro may take more than one line to write. This is no problem as you can use the 
backslash to escape the carriage return. Also remember that you can define variables as 
local within a code macro. Look at the following definition: 


#define Sort Exchange( x, y ) (atin NaN 
ios (UO oy = Y YN 
ngo NX E= V y = he) ) 


You can place the macro in your code as and where required. This will save you 
considerable of typing and thus reduce the risk of mistakes. 


Such code macros do have the advantage that they are faster in execution than function 
calls. There is, though, a price to pay for this speed. As was said earlier in the book, 
they result in more code being generated. This means that your executable code will be 
larger. That is the final tradeoff which faces you when programming in C: size versus 
speed. Generally, if you program for speed there will be some loss of efficiency in 
program size, and vice versa. 
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DEBUGGING AND  . 
TESTING C 


One of the problems with C is that the rules for debugging other languages do not 
apply to it all that well. It is a price that we pay for the power of C. In discarding the 
protection which languages like Pascal provide, we have to accept the problems this 
can bring. 


Often, novices to C can underestimate this difference. They presume that because of 
the similarity between C and Pascal in being highly structured languages, techniques 
which work in Pascal are also applicable to C. Sometimes they are, but sometimes 
they can be completely misleading. 


What is important about debugging is that essentially it is a search and destroy 
operation. First, the bug has to be found, then it has to be fixed. - 


Testing 


Before you can even start looking for a bug you have to know that it is there. The first 
thing you have to do is test your software. Here an interesting point is raised. What is 
the purpose of testing? 


Many, if not most, software authors consider that the aim of testing is to show that the 
software is running correctly. That is one, and certainly the predominant school of 
thought. There is, however, another somewhat academic approach that has a different 


answer. It says that the purpose of a software test is to show the presence of bugs. 


The argument for this idea is long, involved ; : 
The basic point of view is quite simple, It qe Outside the scopaiofithis boak: 


y NW _ Any complex piece of software will Contain bugs 


- Itis impossible to write a series of tests for anything more than the simplest piece 
of software which can demonstrate that it has absolutely no bugs in it. 


- It therefore follows that the only thing you can be certain of proving by any test is 
that a bug does exist. 


- It therefore makes sense to design test to detect bugs, not to show that the software 
is performing correctly, as when all bugs are detected the software will be 
performing correctly anyway. 


Whether you agree with this argument or not, there is one interesting point in it: the 
statement that it is impossible to write a series of tests for anything more than thc 
simplest piece of software which can demonstrate that it has absolutely no bugs in it. 
It follows that you can write a test for a simple piece of software which can show it has 
no bugs in it. Consider the following example: 


add( int a, int b) 
{ 


Diu aao a» LOO) )i return -(0):; 
I DEMON eb > LOO) return (0); 
return ( a + b ); 


This is a very simple piec2 of code to test. If you can write all your functions so that 
they are this simple then you can test all your functions with very easy tcsts. 


To do this, you have to break all your functions do wn into their component parts and 
write each part as a separate function. This is a very good approach to programming in 


$ . theory, but it is not always practical. This was discussed in Chapter 24 on modularity. 


is testing and proving of the very small blocks of a program is the approach to 
testing known as bottom up testing. You start at the lowest level of a program and 
_ work your way up testing each level as you go. 
d 


Alt hough bottom up testing is efficient in proving that the individual functions in a 


gram are working correctly and that no bugs are found in them, it is not very good 
gram design. To do this you need to reverse the process and test from the 


g is fairly complicated and you are best advised to read one of the 
on testing to fully understand it. The following is a brief description 


SNOILONN4 SSIOOUd 


SNOILONNS OHLNOO 


() ureur 


First, the top-level of control functions is tested, substituting the lower level functions 
with stub-functions which provide just enough support to allow the higher level 
function to run. 


For instance, if you have a main() function which calls a function called menu() that 
returns a value from zero to eight according to a selection which is made, menu() would 
be replaced with a stub. This stub function would not print up and display a menu, or 
request an input. It would just return a preset value. 


- Once the top level control has been tested you then move down a level and test the next 
level of functions. 


There are both advantages and disadvantages to top down testing. Really, they are 
outside the scope of this book. The main advantage is that such a testing approach 
does show up weaknesses in the sucture of a program. 


Debugging 


One of the problems with discussing testing and debugging is that it is often referred to 
as two separate activities. In theory, this may be the case. Operationally, they are 
tightly interleaved. So let us go onto debugging. 


First, a very simple piece of advice. If you have a bug, do not sit there reading the 
code. It is very rare that you will spot a bug just by reading through the code time after 
time. What you have to do is go out and hunt it down with all the tools at your 
disposal. 


Frequent Mistakes 


First let us consider a few of the common mistakes that are made in C. Even the most 
advanced programmers tend to make these mistakes, not just the novice. 


Missing semi-colon 


Probably the most common mistake is the missing semi-colon. Here you are 
fortunate in that the compiler will give you a warning that a semi-colon is missing. 
The problem is that the error message that you get will not always refer to the line on 
which the error exists. 


main() 


{ 
dnt 


printf ("Starting Loop") 


for i <10 i < 57 itt ) 
printf ("Inside Loop"); 
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The piece of test code above, when compiled with Turbo C, will produce an error 
message on the line: 


forums = 0; i < 5; i+ 


1 


stating that there is a missing semi-colon. In fact, there is, but not on this line. The 
mistake is on the previous line: 


printf("Starting Loop") 
which should be: 
printf("Starting Loop"); 


This type of occurrence where the compile message actually refers to an ene: on the 
previous line is fairly common. What is happening is that the compiler parses, that is 
scans, the line. As there is no semi-colon it continues onto the next line. There it 
comes across a C construct which it knows, the for. However, as far as the compiler is 
concerned, the for cannot legally be here in what it considers to be the centre of a line. 
It therefore reports an error. 


Excess semi-colon 


: : ; e it SÍ not 
A far more difficult problem with semi-colons concerns putting one where it ws s 
be. You become so used to putting semi- colons at the end of a line that, you s 


put them everywhere. This can lead at times to very unexpected results. Consider the 
following code fragment. 


main() 
{ 


Birnie de 


printf ("Starting Loop") ; 


OE (GEO Sp alesse pg 
Printf ("Inside 


n Loop"); 


The output intended from this code 
Was: 


Starting Loop 
Inside Loop 

Inside Loop 
Inside Loop 
Inside Loop 


Inside Loop 
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En et UuMETY Tax eon: Oo 


What we will actually get in this case is: 
Starting Loop 
Inside Loop 


The reason for this difference is that there is a semi-colon at the end of the for 
statement. As a result we have an empty or do nothing loop. Such loops are valid C 
code so will not produce an error and at times can be useful. 


for ( i = 0, j = max; i < 23; i++, max += change ); 


The above is a perfectly valid piece of C code which exists inside an empty loop. What 
we want to do here increases the value of max. There is no way, therefore, that a 
compiler can sort out the occurrences of empty loops which are valid and those which 
are not valid. 


There are only two statements which can produce an empty loop. The for and the while 
Statements. It is advisable to look through your code for every such statement and 
check that it is not an empty loop created by mistake. 


One way you can do this is by means of the CROSSREF program we looked at in 
Chapter 20 on the linked list. This produces a listing of all C tokens, sorted in 
alphabetical order, and a list of the lines where they occur. One set of these lines will 
contain all the fors and the other all the whiles. 


Another good idea is never to put a semi-colon on the same line as a for or while. If 
you want an empty loop, place it on the following line: 


for ( i= 0, j = max; i <-23; i++, max += change ) 


LI 


_ This has two effects. It shows clearly that you had intended the loop to be empty. It 
also makes it easier to write a program which will look for instances of a semi-colon 


a line with for or while. There are a number of programs around in both 
amercial and public domains which will do this. You might like to get one, or 


etter still, have a go at writing your own. 


=> 


7 that is the curly brackets used to hold compound statements, are another 


source of problems. These come basically in two forms. First, the none use 


if ( num < max ) 
another gc(); 


and: 


if ( num < max ) 
( 

another go(); 
) 


are perfectly valid code. If though, there is to be more than one line of code relevant to 
a test, then it must be within braces. So: 


while( num « max ) 
( 
another go(); 
set score(); 


) 


is correct. Unfortunately, if you write the above and leave out the braces you still get 
valid code, but not what you intended: 


while( num < max ) 
another go(); 
set score(); 


In the first piece, so long as num is less than max the function another. go() will be 
invoked followed by the invocation of set, score(). In the second set of code, so long as 
num is less than max the function another go() will be invoked. Only this time 
set score() will not be invoked until num is greater than max. 


You should really take care when dealing with these statements which impose a test and 
carry out actions. One way followed by many programmers is always to use braces, 
even if you are only having one line connected with the test statement. So you would : 
— have: an 


while( ( Tet = getch) ) limen 


{ 
IxNavEgame 0: 


zm e: 
4 ough the compiler will not report errors ae a pair of braces is missing, what it 
` pair is missing and it can often be re onien is that it will not tell you — 


A ; 
whi ofa P > ‘ 3 paa 
a here with one of the public domain Program d to find out, You can obtain some —— 

h ei Nur 
he't 7 oet 


RE" 


S. 


p Missing comment closure 


A rather difficult problem at times is the missed comment close. If you fail to close a 
comment correctly the compiler will continue to regard the code as a comment until it 
finds a valid comment close. This may comment out a large part of your program. 


The basic answer here is to be careful. It is possible to modify the code for 
CROSSREF so that it just prints out comment lines. This can be useful, as if you get 
! a printout of comment lines and find code in the middle, you know something is 
wrong. 


Program 093 gives you a variation on CROSSREF which does this. 
However, it does need some cleaning up to handle line feeds, so you will need to do 
some work on it. 


[RR KR I IO IOI OOOO Ok 


* 


* Program 093 
* This program shows those characters between * 


* comment delimitators. x 
RRR KKK KKK KEKE ARK RIK KK KK EK KKK KERR RK KR RK RK / 


E #include <stdio.h> | 
- #include <stdlib.h> 
E #include <ctype.h> 


PALZEXZEZZZSZEZZZSZZRZZZZZZZZZZZZZEZZZZZZSISISSSSROSI 


* definitions * 
ARIK KK II KR RRR RK RK RR RRR KK RK / 


BOOL 
DQUOTE 
SQUOTE 
SLASH 
ASTERISK 
EQUALS 
FALSE 
TRUE 


MAXWORDSIZE 32 
MAXSTRLEN 255 


FO TI III III IKK KOK RIOR TOK KO Ok 


pe Defs E 


UkOK KC XXX III XX TKK / 


/* program line 
: /* next line */ 


ERN ae 


EZSLERGOR XO COO KANKAAN AEAEE 


n Globals x 


DIOC De Die We AAR KERR Ae Ae Ae AREER Self odd SOLI KK RK KK / 


program_type *start_prog; 
int comment flag, line number; 


main( int argc, char *argv[] ) 
{ 
difta arge < 2 ) 
{ 
puts("Usage : comref < sourcefile >"); 
exit (0); 


read file ( argv[1] ); 
process file(); 


) 


[III III II II III I III OI III III IOI IITA TON 


* read file, reads the source file into memory 
SO I OI OI IOI II IO IOI ITO IO IA II ATI IIA | 


* 


read file( char *filename ) 

( 
ELLE *fp; 
Program type *current line, *last line; 
char buf[MAXSTRLEN], *tmp; 


fp = fopen( filename, "r" ); 

if ( fp == 0 ) 
puts("Cannot open input file to read."); 
exit (0); 3 

start prog = 0; 

while ( ( fgets( buf,MAXSTRLEN, fp )) != NULL ) 


( 


current line = malloc( 
if ( start prog == 0 ) 
start Prog = current line; 


sizeof ( program type 


else 
last line-»next = 

current line-»next = 9; 

tmp = malloc( strlen( buf ) + 1 Ve 

strcpy( tmp, buf ); LU 

current line- 

last dida de UEM EDS 


current line; 


tmp; 
current line; P; 
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p 


m [Dok e kc he nie e hehe e he e fe he e e fe e he t e e e e e he he e e ht e e Re e e e e e e e e e e e e e e e 
ix * process file searches comments * 
OK Oe CO Ok e Oc OK KO OC OC OC OK eee OCOR OK OC OO OCC OC OK OC ORC OC OR 0 e 0 e e XJ 
process file() 
t 
| program type *current, *last; 
char buf(MAXSTRLEN]; 
comment flag = 0; 
current - start prog; 
i line number - 1; 
puts("Start Processing"); 
while ( current != 0 ) 
{ 
strcpy ( buf, current->prog line ); 
get_comment( buf ); 
last = current; 
current = last-»next; 
line_number++; 
} 
Sý puts("End Processing"); 
7 } 


"LRASZARZZRZZAZAZAZZSARSASZRIZSRSSRRSASRSSARSASSISISSISSISI 


* get comment reads the in memory file line by  * 
* line checking for comments. Characters inside * 


* comments are printed ix 
OCC OK Ce ek KK OR OR KOC Oc ke e ek e e ke IOI TOT ke e e e ee e f 


$E. get comment ( char buf[] ) 


char word(MAXWORDSIZE], let; 
int num,cur_char,q flag,sq_flag; 


cur char = num = q flag = sq flag = 0; 


while ( buf[ cur char ] != 0 ) 


dif ( let == ASTERISK && buf( cur char + 1 ] == SLASH. 
|. — eomment flag = FALSE; 
+; a " 


S 


if ( q flag ) 


{ 
1 


if ( let == DOUOTEL) = ts 


q flag - FALSE; 
cur char-**; 
continue; 


if ( sq flag ) 
( 
if ( let -- SQUOTE ) 
sq flag - FALSE; 
cur chart; 
continue; 


) 


if ( let == SLASH && buf[ cur char + 1] == ASTERISK ) 


( 
comment flag - TRUE; 
putchar (let); 


if ( let == DQUOTE && sq flag == FALSE ) 


if ( let == SQUOTE && q flag == FALSE ) 


sq_flag = TRUE; 
} 


cur char**; 


Assignment — equality mix 


A mistake which is far more common than most C programmers like to admit comes 
directly from the power of C. This is where an assignment is made in place of a test 


for equality. 


The C test for equality is == whilst the assignment is =. Unfortunately, it is very easy 
to enter: 


ic QU 


when what you meant was: 


uages this would not matter, Th 


an à e assi : 
In muy e the compiler. In C, thoug assignment in a 


^ test situation would 
h, it is a valid Stat DR 


ement. What you are 
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assign the value of B to A 
if the resultant value of A is other than zero then 
the test is TRUE. 


There are times when such assignments are useful in programming. With Turbo C you 
have an advantage over many other Cs. The compiler will generally warn you when it 
finds a suspicious assignment of this type. Do not rely on it, though. 


Pointer initialization 


When a pointer is declared it does not point to anything useful. Before you can make 
use of a pointer you must assign an address to it. 


This might seem fairly obvious. Nonetheless, it is surprising how often problems 
with programs come about because they are trying to make use of an un-initialized 
pointer. One of the most common causes of this ‘s when the use of a pointer is 
subject to a conditional test. Turbo C is quite helpful here in giving warnings of 
possible use before initialization. Such warnings shouid be studied carefully. 


Error Detection 


There are essentially three types of error: syntax errors, program errors, and the horror 
of horrors, latent errors. Within these three types there is a wide variety. 


Syntax errors 


é 
Of all the errors, syntax are the easiest for you to find. In fact, you do not need to find 
them as the compiler will. Unfortunately, it will not always tell you where the error 
is, or even the correct type of error. 


We looked at one of the reasons for this earlier in this chapter when we discussed 


d missing semi-colons. Another compiler trick is to report an error different from the 
—. one which exists. This usually happens when you have an error in one part of the code 
|. which still produces acceptable code, but makes some of the following code invalid. 


; If you find that you get a syntax error reported by the compiler but despite your best 


find nothing wrong with the code where it is reported, look again at the 
e. One thing well worth checking in these circumstances is that you have. 
nied out a section of code. 


Y: 
far more set se Est s they will go undetected by the compiler, although \ jt th 
i e usome, warnings of suspect code. This is the ¢ ase 


with one of the most common causes of program errors: the incorrect use of 
assignment and equality operators. 


Fortunately, a program error will show up in the fact that the program will not run 
correctly. In such cases you have work your way through the program and try to find 
out why it is not working in the way you expected. 


Code expansion 


If you cannot find any obvious reason in the code why you are not getting the results 
you anticipated, it might be worth expanding out the code. This means obtaining a full 
listing of the code with all the include files included and all the defined macros 
expanded. You can do this by running your source code through the C preprocessor. 
Unfortunately, you will probably find that this is not well documented in your 
manuals. 


M 


The method given below is the one I use with Turbo C. 
- Setup a temporary directory below the Turbo C main directory. 


- Copy over to that directory my source code, all include files and the Turbo C file 
CPP.EXE. 


- Enter the command CPP <sourcefile>. 


This will result in a file with an I suffix to it. You can print this out and have a full 
listing of your code with all your macros expanded. 


As an example in one program would not work and no fault was apparent in it. It was 
not until the source was expanded out that an included macro was found which was not 
doing as expected. This was the cause of the problem. 


Lints 


Turbo C is fairly good compared with many compilers in providing warnings on 


aH . In the traditional Uni P 
ssible incorrect usage. in onal Unix backgroun 
help, 50 à tool known as a lint was developed, HOP C we did pot have sum 


j e histicated syntax anal : 3 
E int is a Very SOpAISU l alyzer which 
z à A report errors and give warnings. The range ait 

— extensive than those produced by the standard compil 
LÀ 


ll go through your source code 
ese warnings is often far more 


^" » 


With its effective warning reporting system, Turbo C offers you most of what you will 
get from a lint, but not quite all. The benefit of a lint for the Turbo C user is possibly 
marginal. However, if you are using a compiler which does not have an extensive 
warning system you may be well off obtaining a lint. There are a number in the public 
domain, or a very good commercially distributed one called PC-Lint(TM). 


Cross referencers 


Cross referencers provide you with a list of C tokens and information about where these 
are used. They are often useful when you know that something is getting the wrong 
value, but you are not certain where that value is coming from. 


There are a number available in the public domain, mostly called XREF. These 
generally produce a list of tokens and line numbers. The version given in Chapter 20, 
CROSSREF, provides a context printout of the line containing the variable. A sample 
of part of the output of this program is given here when it has been run on Program 
088. 


coc CES ===- 
006 > #define CLS printf ("%c{2J", 27) 
074 > CLS; 
125 > CLS; 
176 > CLS; 
240 > CLS; 
> 
> 
> 


edit_flag = FALSE; 
if ( ok() == FALSE ) exit(0); 
df ( let == 'N' ) return ( FALSE ); 


T "ama 


Cas - 


«m 


a 


T E —-— 
; ri E Tw dat = 
K r r A 


E e c 


oe 


003 > #define TRUE 1 


150 » ihile( TRUE ) | 
154 > if( let == 'Y' ) return ( TRUE ); | 
173 > while( TRUE ) 

184 > while( TRUE ) 

205 » if ( ok() == TRUE ) 

215 » edit flag = TRUE; 


The full output of CROSSREF is much longer. The above, though, shows the type of Le 
information which programs of this type provide. If you found a problem with a 8 | 
program and suspected that it might be related to a specific variable, by using a cross- BM 
referencing program you could quickly find all the lines of code containing that | | 3 
variable. | 


There is a problem with both XREF and CROSSREF in that they ignore strings. If 
you have a message which appears at the wrong time it is often useful to be able to 
find out where it is coming from. Program 094 provides you with a basic utility to do 
this. 


[RR XX OO OO ON ROI ROI XO X 


* Program 094 "E 
* strfind.c | 
* Prints out a list of strings with line number. 
* usage strfind <sourcfile> 


RRO OR OR IOI XC XX CAEN OX Ex x / 


#include <stdio.h> 


€ emn 


define DQUOTE '"' 
idefine BSLASH '\\' 


main( int argc, char *argv[) } 


{ 
ALUO AGP 


char buf[256],last,this; 
int blet; 
int line num = 0; 


jf. ( arge < 2 ) 


puts( "U 


Sage strfj 
3 nd 
exit(0); Ssourcefile> « 


"ero DERE (DH 0L Fer} 
pen( AL en "m 
) 


zn 
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puts("Cannot open source file."); 


m exit(0); 
) 
while( fgets( buf, 256, fp ) !- NÜLL ) 
( 
line num**; 
last = this = blet = 0; 
while( (this = buf[blet++]) != 0 ) 
{ 
if( this == DQUOTE && last != BSLASH ) 
{ 
printf("$03d > %s",line_num,buf); 
break; 
) 
3 last = this; 
Í ) 
) 


1 ) 


Both CROSSREF and STRFIND are very basic utilities when it comes to this typc of 
work. There are a number of commercial programs which provide a higher degree of 
functionality. One which I recommend is a program called VICAR, from Iansyst Ltd. 


Call listers 


Another type of utility program which can be very useful in debugging program errors 
is a call lister. These programs provide you with a list of all functions called from a 


specific function. 


: It is common to find that the cause of program error is either a function not being 
- called when you would expect it to be, or a function being called from the wrong place. 


; Ther are a number of these programs available in the public domain, one of the most 
nown being CALLS. 


one ‘of the best programs I have found in this field is TREE 
R from Albedaran Laboratories in California. If you are going to do 
work, it is well worth aquiring this. 


, ns aroun d to tidy up your source code and provide you 
an invaluable aid when you are looking E. 
ide in a badly Jaid out piece of code. d 


One of the most commonly used is a public domain program called CPRINT. There 
are a number of versions of this and generally they provide quite an easy to read output. 


SOURCE PRINT from Albedaran Laboratories goes further, providing you with 
graphical guides to levels of nesting and including indexing and cross referencing 
utilities. If you are doing large amounts of C coding this utility is very useful. 


Latent bugs 


Without doubt this is the most serious bug facing the C programmer, mainly because 
it is the type of bug which is most difficult to find. 


A latent bug is one which will not manifest until certain conditions apply, and usually 
this means the one set of data for which you did not test the software. 


Once you identify the condition which will-cause the latent bug to appear, it is fairly 
easy to track down and correct. The problem lies in detecting them. 


There are two basic rules here. First, carry out thorough testing. Do not just test 
functions with the values they are supposed to receive, but also with all possible values 
which might be sent to them. 


The second rule is to follow the programming practice known as defensive coding. 
This means keeping the data interaction to a minimum. If possible, at the lowest level 
each function should carry out one task and one task only. That task should affect only 
one item of data. By doing this it is far easier to check the effect of each function on 
the data it is handling and to ensure that a change to one data item is not causing an 
unwanted result in another. 
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Appendix 1 
C CODE LAYOUT 


There are many different ideas about how C code should be laid out. The essential 
point is to find a style which suits you and to stick to it. 


Some readers probably want a firm guideline for C code layout. The following is one 
which I have given as a standard for a number-of commercial programming operations. 


It works. 


I do not claim that this is the one and only correct way to lay out C code. There are 
many others. It is not even the way followed in this book. Also, I do not recommend 
that you take it as it stands. Coding standards have to be worked out for the situation 
in which they are being used. Have the following standard as a base and write your 
own version which suits your own requirements. 


1. Each source file should start with an Identification Descriptor. This will have the 
following structure. 


- Begin Comment (/*) 

- Space 

- Title (The Program Identification Name + Source File Name) 
- Subtitle (Detail of program structure this program belongs to) 


3 Space 

- Classification 

- Year 

- Programmer 

- Owner 

- Status (See below) 
- Date 


- Functional/Structural Description in brief 
- Portability synopsis 


- Space 
- End Comment */ 
- Space 


The program status can be one of the following: 
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dies 
Seu 


Outline 

Draft 

Prototype 

Test Alpha, Beta, etc. 
Release 


An example of a program identification block would be: 
/* 


Editor l-edit.c 
L-Taal Editor module. 


Copyright: released for non-commercial purposes. 


1985 Interspike Ltd 
N. G. Backhurst & R. Stuurman 


Prototype. 
Version 2.00 This is the first C version written 
3lst November 1985 


The module will take the input from the keyboard and assign it to 
the program structure. All command and option input will be 
validated before acceptance. The command and action lines are 
stored in two buffers, com buff & act buff. Once the input has 
been completed and verified, the contents of the buffers are 

| written into a structure of type prog_struct, space being 

obtained for this using malloc, and the pointers of the preceding 
and following line structures are adjusted to include the new 
line in the program structure. 

e: 


The screen handling functions (SCR ) are all system dependent. 
All other functions are portable. 


as 
x/ p 


d 


2. Tabs are used for program indentation; 
spaces. 


the standard level of tabbing being three. 3: x 


3, A brace is generally on a line by itself, 


Braces are indented to the same depth as the statement that invoked the block that 
they frame. 


In variable initializations, the opening brace may be placed on the same line as the 
equal sign, but the closing brace must have the same indentation as the opening 
one. 


No statement may appear on the same line as a brace. 


. A block begins with a left brace and ends with a right brace. Its contents are 


indented an extra level to indicate the nesting depth. 


Whenever a block is longer than 24 lines (a standard CRT page) a comment should 
follow the closing brace to indicate the block that the brace closes. 


This applies to whole functions as well as regular blocks. 


This rule should also be used with shorter blocks when block nesting makes the 
code complex and these comments improve the readability. 


The opening and closing braces of a block are always indented identically. 


The case/default labels of a switch statement are always indented a level, like 
statements in a block. The statements that follow these labels are always indented 
an extra level to improve readability. 


Regular labels (destinations for gotos) are always placed at the left margin regardless 
of nesting. Such labels should be commented saying where the gotos which refer to 
them are situated. 


_ - The null block () should be avoided. It is better to use the null statement. 


E Ifa single statement is used instead of a block, it is indented a single level, just as 


E 


_ if it were surrounded by braces. 


av . . " 
SEE ";") are indented in the same way as regular 


while 


" 


a> bi C fex 


- Binary operators (for example, +, -, / ) and assignment operators are delimited by 
white space. 


Wa x - j; a *= 2; 


Unary operators are not separated by space from their operands. 
itt; -j; 


- Parentheses are added to improve readability in complex expressions, even if they 
are not required to produce correct evaluation. 


amen j * k.) + COL an Se, 


- The return statement wil! always have parentheses surrounding its expression. 


return (answer); 
With many Cs this is compulsory anyway. 


- No white space is placed between a function name and the parentheses of its 
argument list. 


get_screen_square(tleft,tright,bleft, bright) ; 

- Asingle white space is place between a keyword and its parenthesized argument. 
for (i = 0, j = strlen(word); i < j ; i++, jay) 

- Parentheses should be adjacent to the arguments they enclose. 


- A comma is bound to the argument that precedes it and should be followed by a 
single space. 


6. Operators such as "-> and "." (used in structure references) directly bind to their 
arguments with no intervening spaces, 


Comments are added liberally to make the pro T T 


If the comment is outside a function it should be surrounded b tbo 
; y a comment box. 
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E [OK e Se he e c ke e kc ke c e oc e kk OK Ok e OR REO Ok KK Ok OK e e ke CK e ke e e ke e o 


* get name takes the input from the keyboard and places * 


i * jt in the buffer name. A check is made to ensure that* 
* the first character is an upper case letter and only * 


* letters are accepted in the input. 
RRR Koc cO cce oc lc oc okcoc oce Kc oc Oc oc Koc Oc OC Ok OK oe c OCC OC kc COR OCC C Ke CK OK Kk XX ke e / 


* 


get name (name) 


- Where the comment in a comment box relates to a specific function there should be 
one line between the closing line of the comment box and the header line of the 
function. Where the comment in the comment box does not relate to any specific 
function, the comment box should be separated from the main body of the program 
by at least four blank lines above and below. 


- If acomment in a function takes more than one line the start and end token should 
be lined up with a star at the start of each comment line. The whole comment 
should be indented across from the main body of the program. 


if ( !get scr(tl,tr,bl,br) ) 

return ( clear ); /* Test if the screen 
* is clear. I fats 
* return to the screen 
* update routine. 


: x/ 
* <7 
else 
m if (confirm clear() !- YES ) 
i escape update(); 
de. else 
É return ( clear ); /* If the screen is not 


* clear, check if safe 

* to clear. xg 5e Oy 

* return to screen 
update routine, if 
not, escape the update 
procedure. © 


Even if the 


= 
- 


7, Variables should always be declared, even if the version of C ou are using has 
default variables. Aiways explain the purpose of your verübi com than Mec 
counting variables. 


- Declare the variabies in logical groups, and include a comment on the same line as 
the declaration to describe the function of the variable. 


- Avoid numerous declarations on a single line, 

- Explain complex pointer declarations, 

- Variable names are always lower case only. 

- Extemal variable declarations must be indented a single level for greater readability. 


- If you have a number of declarations on one line or many, put them into alphabetic 
order, 


8, Constants created with #define are always upper case. Macros created with #define 
will have the first character upper case and the rest lower case. 


Appendix 2 


ANSI SCREEN CONTROL 
CODES 


The following set of C functions carry out various screen operations using ANS| 
Screen Control Codes. For these to be used you must include device = ANSI.SYS ir 
your config.sys file. 


J II RII ITI TOKIO OORT OI OO 


* move up() moves the cursor up by the number * 
* of lines specified in lines. If the cursor * 
* reaches top of screen, or is at the top of x 
* screen no changes are made. * 


Kt c c e e e e e e e ee e e e e e ee e e e e e e OO e e Re e Ce e ek e e e e e e x x 


move up( int lines ) 


( 
printf ("%c[%dA",27,lines); 


JR IK ie FBI IOI TOOK OK IOI III III III TORK IO 


* move dn() move the cursor down by the number * 
* of lines specified in lines. If the cursor * 
* reaches the bottom of screen, or is at the * 
* bottom of screen no changes are made. * 


LEZSIIITIITITIIRZSZEZZRRSXZRAXASSSRSSSSSSSSSSSSSSZLZILSIS 


f move dn( int lines ) 
E { 
printf ("%c[%dB",27,lines); 


J[ RORI I de de OR ORC OX C CR III DIO OX ROC OOO TOSS OOS IOI II 


* move rt() moves the cursor to the right unless 
* it is at the rightmost position on the screen. 
* The number of columns to move is specified by 


* 
* 
* 
* 


TRIES RECETA AA [R KL E I ER BD EIN NOV o K Kol Ro Kok meme | 


move rt( int cols ) 
H 
printf ("%c[%dC",27,cols); 


[RR TK IRI OO TICK TOR RTO TK 


* move lt() moves the cursor to the right unless * 
* it is at the leftmost position on the screen. us 
* The number of columns to move is specified by A 
* cols. p 


CK OK OCC OKCOXON KOC See e ee ee cee cee ee eee ee) 


move Ie int Corsi) 
{ 

printf ("%c{%dD",27,cols); 
} 


[III IOI IOI III OR III III IIE EES 


* put cur() places the cursor at the row and e 


* column specified. 


"---—————————IIDIREFIIIIIISSSRLALLL LESS 


* 


put cur(int row, int col ) 
( ! 

printf("$c[$*d;$dH",27,row,col); a) 
} i 


[RIOT IOI ISI IOS 


* cls() clears the screen and returns the cursor * 


* to the home position. 


n--———————ÉOOOPPPPDDRRRRRRRRERAE SS d d / 


* 


cls() 
( 
printf("$c[2J",27); 


) 
TEER ERLE EEE PI EY RAT CICERO COGO OO OQ OOo 
* set screen() sets the screen mode. This is set * 
* up for the AMSTRAD PC1640, but should be correct* 
* for most true compatibles. 4 
* Mode Description h 
X o 40 x 25 Black & White G 
x 1 40 x 25 Colour T 
& x : 80 x 25 Black & White x 
z 7 80 x 25 Colour * 
y a 320 x 200 Colour * 
K 320 x 200 Black & White * 
^ 7 630 x 200 Black & White * 
Wrap at end of line * 


XC A WO X X n 
** 
MEXWRESERAWENRAARN RARIOR RERO EO / 
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pit at Se 


set screen( int mode ) 


4 
l printf ("tc[=%dh", mode); 


) 


III UDI TO i a ROC CN 


* save cur() saves the current cursor position x 
* to be restored later. £ 
- OR ROR OO / 
E 
Lem. save cur( void ) 
b ( 
= printf ("%c[(s",27); 
) 
YAE e doo vc de eee fe de ee e c e eje he e t e c e t e ec je e e e e e e t e de e dee Ye e 
wu * rest cur() restores the cursor at a previously* 


* saved position. * 
OO OK XX Xx / 


2. rest cur( void ) 
{ 


printfit*c(u"727)7 


Appendix 3 


FUNCTIONS $ 


This appendix contains a number of functions which you might find useful. Each is l 
provided with a small driver function main() for development and testing purposes. j 
|] 
y 


You will need to adapt the functions for the situation in which you will be Bu 
l This is especially true with the functions which are being passed BELT p: : ge 
j There is no reason why these cannot be passed arrays of type float or dou 3 X E 

ll that for a basic version I always write using integers. This makes basic debugging 


much easier. 


eee 
[ORO TO OO OO 


* 
* compound interest() returns the amount of 


| * compound interest on the principle, over a 
* number of time periods, at a rate per time 
* period. The return value is of type float. 


kett 
RRR RR RR OK RO / 


* 


#include <stdio.h> 


int time, float rate); 


B 


| float compound interest( int principle, 


main() 

{ 
int principle, time; 
float rate, interest; 


Printf("\nEnter principle : "); 
scanf ("aq", &principle); : 
getcnar(); 
Printf("\nEnter gacek OYA 
Y scanf ("®£") crate); 
> getchar(); 
printf ("\nenter time : "); 
UI AGE GEC yin 
Setchar(); 


Printf (N\n\nPr incible td, Time td, Rate tf ",principle, time, rate) 


P 
4 


O 


interest = compound (principie, me, rate); 
printf('"NnNnlfInterest due is %f\n";interest 
-— } 
E float compound interest( int principle, nt me, float 
{ 
lie aA 


float interest, total; 


total = ( float ) principle; 


tox GeO inc time; i++ ) 
{ 
cotcalex= (1 + (rate / 100) ); 


} 
interest = total - principle; 
return ( interest ); 


[RRR KK RK RK RRR KR EK KKK KE 


* average() returns the arithmetic mean average * 
* of the contents of an array of integers. It K 
* requires to have passed to it the address of A 


* the array and the number of elements involved. * 


PRR KKK KR KKK kk II IO Ok kk kkk k kk k k iek kk / 


float average( int arrayí], int members ); 


main() 

{ 
int values[5],number; 
float mean; 


for ( number = 0; number < 5; number++ ) 
{ 
values[number] = number + 1; 


mean = average( values, number ); 


printf("Average is %f\n",mean); 


float average( int array[], int members ) 


{ 
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float mean; 
Sne i, total; f 


for ( i = 0, total = 0; i < members; i++ ) 


total += arrayí(i): 


mean = total / members; 


return ( mean ); 


OR RO ROO RO KE 


Progression() returns the total value of an s 


* 


| arithmetic progression. It needs three 
values passed to it. The start value, the i I 
| number of terms and the common difference. x I 
| RO ISO IIR IO SII III IIR IIA IS / i 


| .nclude <stdio.h> ; 


i 
| -oat progression( float start, int number, float difference ); 


| 


E 


f 
| float first, change; 
int num; 


printf("Enter first value "); 

scanf("*f",&first); 

getchar(); 

printf("\nEnter number of elements "); 

scanf("$d",&num); 

getchar(); T 
printf("NnEnter common difference "); 

scanf ("%f", &change) ; 
getchar(); ET 
printf("\n\nThe total is Sf n",progression( first,num,change )); 


progression( float start, int number, float difference ) 


oat total; 
is 


Oy RAE 
» NR = Start; i < number-1; i++ ) 


start += difference; 
total += start; 


A 


4 f return ( total ); 

i ) 

i 

1 i V Aa R EN NENIA AEAEE EEE kc to e ec efe e eee ee d e e ve Se x 

1 i * std dev() returns the standard deviation for is 
| * the contents of an array. It is passed two * 


| * values, the address of the array and the number* 
* of elements. * 


KKK KKK KKK ER KK RR 42222222 20422 0101/0 11/4 


#include <stdio.h> 
$include <math.h> 


double std dev( int array[], int members ); 


main() 

{ 
int values[99],number; 
double standard dev; 


{ 
printf("NnInput number 99 to exit "); 
scanf("$*$d",&values[number]); 
getchar(); 
if ( values[number] -- 99 ) 
( 
break; 
) 
number**; 
) 


standard dev = std devi values, number ); 
printf("SD = &f\n",standard dev); 


/ double std dev( int array(], int members ) 


square tot, variance, average; 


f ) - 0s 
for ( 1 = 0; i < members; i++ ) 


total += array(ij; 
Square tot += ( array(i] * array[(i] ); 
count++; 


average = total / count; 
variance = ( square tot / count ) - ( average * average ); 
dev = sqrt( variance ); 


return (dev); 


[OR EKER XXX XX 


* reverse() reverses the letter order in a x 


* string which is passed to it. 


XOk X OK Ok Ye X Ok REE KERR x x x / 


x 


void reverse( char *string); 


main () 
{ 
char word(] = "TESTING"; 


printf("$s \n",word); 
reverse( word ); 2 
printf("&s \n",word); 


void reverse( char *string ) 
{ 

Ince e 

char hlet; 


j = strlen( string ) - 1; /* reduce by one to avoid 
* swapping terminating zero. 
x 
MAD 3) Po") | 
hlet = string[i]; 
String[i] = string[j]:; 
' string[j] = nlet; 


LIII 
* 
RRM RR RR KR KK AEOR ACER EX REX E 


* min max() 


* passed 1s basic statistical tool. It is * H 
a d 

* element n array of integers, the number of * ifi 
S 

E tn the array and pointer to two * 


intege 

rS to 

CASU Ud f e SP RUE return values to. " 
* 


*x* 
TR RRR AERA / 
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#include <stdio.h> 
void min max( int array[], int elements, int *min 


main() 


{ 
int values[(10],count,highest, lowest; 


highest = lowest = 0; 


— for ( count = 0; count « 10; count++ ) 
( 
printf("\nEnter a number "); 
scanf("$d",&values[count]); 


getchar(); 


min max( values, 10, &lowest, &highest ); 
print f("\n\nLowest is td and highest is %d ",lowest,highest); 


void min max( int array[], int elements, int *min, int *max 


( 
int i, low, high; 


low = high = array[0]; 
for( i = 0; i « elements; i++ ) 


if ( array[i) > high ) 


high = array{i}; 
fe (arraya) < low.) 
low = arrayí[i); 
} 
*min = low; 
*max = high; 


} 


J Ik c oic c hc IK ICR IK e ke SICK I KIKI KA IA KAKA AKAIKE ARREARS 


Ll 


* mem rep() returns the amount of memory on the 
* system. This is done with a call to the 

* Memory Size Service using the ROM BIOS inter- 
* rupt call 18 ( hex 12 ). 


aE 
de I OI I ORO XC KC OA Ok XC CK IKI EN / 


* 
* 


* 


#include <stdio.h> 
£include <dos.h> 


main () 
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printf("Memory &$d K \n",mem_rep()); " 


— 


mem rep () 

i 
int mem; 
geninterrupt( 18 ); 
mem = AX; 
return í moem:/; 

) 


*** 
kk kck x XO 
PRS ea ea ee ek a R KEE 


1 * 
* fill mem() fills the memory starting from the 


location passed to it as start for the number 
* of bytes passed in length with the value 

* passed in ch. 

This technique is often used t 
with zeros prior to using a ra 


* 
s * 


* 


o fill a buffer * 
w disk sector x 


1 d A * 
* write to fill the disk sector with ee 5 
; e 
* process used for security t9 overwri E 
* which is sensitive. AS 
ORAN US sss) =e / 
finclude <stdio.h> 
#include <stdlib.h> 
main () 
( 
char *ptr; 
int i; | 
ptr = malloc( 100 ); i 
fill mem( ptr, 100, 'A' ); 
for ( i = O7 3 <<) LOO 55t ) 
{ 


printf("%c",*ptr); 
ptrtt; 


fill mem( char *start, int length, char ch ) * 
{ 
dnte 


Ro iM 0; 


( i « length; i++ ) 


5 “start = ch; 
Start++; 
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Appendix 4 


ANSWERS 


[ORO IO TO OR I. 


> 


* Answer 1 


* * 
* This program takes the input of two single * 
* digit integers. It divides the first integer * 
* by the second and prints the result of the X 
* division and the remainder. x 
* * 
* Input stdin x 
* Output stdout x 
* * 
* N. G. Backhurst May 1987 * 


|bsSiiiSsSsSSsSXSsssscsfffl f 2222222 2222405202502 222025222 0 


#include <stdio.h> 


main () 
{ 
int f_num, s_num, *pfnum, *psnum; 
/* declare two integer variables 
* snd pointers to them. 
x7, 


f num = s num = O0; 
/* initialize variables to zero/ */ 


pfnum = &f num; 
psnum = &s num; 


get nums( pfnum, psnum); 
/* call function to get numbers. ey 


printf("\ntd divided by td is ", SIS MEAM 
printf("$d with a ", ( f num / S num ) t Ner. 
printf("a remainder of td.\n", ( f num L) ; 
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aj 


f FR Rede e dede Pe ee e e dde Ye e e de OX ORO EERE EEE 


* get nums() x 
* * 
* The function get nums recieves two pointers X 
* to integers as arguments. It takes the input * 
=a * of two integers and assigns them to the x 
= * address pointed to by the pointers, i 
RRR RO ee RR RR a WK KW WX Ree ww f 
" 
= get_nums( int *fp, int *sp ) 
{ 
= int a, b; 
= 
= printf£("\nEnter two single digit numbers.\n"); 
zi printf("\nFirst Number Bg «n 
= a = getchar() - '0'; 
=| getchar (); 
printf ("\nSecond Number he 
b = getchar() - '0'; 


getchar(); 
*fp = a; 
*sp = b; 


/* Assign integers to addresses pointed to by the pointers 
* so making the values known to the calling function. 


v, 


) 


* 
DOO WC XOCXCKOXOXOCOXCOIONOOXORONEONON OCC R ON KR OUI TT 


w 
* Answer 2 


* Function to convert upper ase to lower 
x MANANNAN RO YOXORO KON ON OXON ORO REOONOEERK UE ee 


LJ] 


char make lower ( char let ) : 


( 
if ( let « 'A' ) return (let); 
if ( let > '2' ) return (let); 
return ( ( let = 'A' ) « ‘a! ); LOS 
) à 


[OSCR ION ICIS IC IDR WCE RR SERRE WR DEG RC EORR TOR 
Answer 3 
Function to retur 


n a string, the number of 
characters which can be inputted being 


LÀ 

w*w 

LÀ 

> Qimited to the value Passed as num. 

s Use cgeta( Shar*, int ), * 
* 

* 


There i - 
for use 2: 09 Provision in this version to allow* 
kawanenan QUT or backspace, i pie " 

tiny Mtem 


NR 


s x» 4 * 


cgets( char *array, int num ) 


{ 
char let; 
inte 
4 c (95 


while ( 1 ) /* Endless loop */ 


let - getch(); /* get character from keyboard */ 
Het DI3 S carriage return */ 
( 
*array = 0; 7* Terminate string */ 
printf ("\n"); 
return; /* and return. */ 
) 
Ae (C Sl & spiny )) /* maximum number not entered */ 
{ 
i**; /* increase count */ 
*array = let; 
printf ("%c", let); 
array**; /* increase pointer */ 
) 
) 
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Appendix 5 


SOURCES 


The following list of companies provide goods or services referred to in this book. 


Aldebaran Laboratories Inc, 3339 Vincent Road, Pleasant Hill, CA 94523, United 
States of America: 
Source Print, Tree Diagrammer. 


Grey Matter, 4 Prigg Meadow, Ashburton, Devon, TQ13 7DF: 
C Compilers, Development Tools and Libraries. 


Iansyst Ltd., Omnibus Building, 41 North Road, London, N7 9DP: 
VICAR, Variables in Context Analyst and Reporter. 


1512 Independent Users Group, P.O. Box 55, Sevenoaks, Kent, TN13 1AQ: 
Public Domain C Software - Available to Members Only. 


Interspike/Intersoft, Holtrichtersveld 709, 7327 DD Apeldoom, Netherlands: 
C Consultancy and support service and Public Domain Software in Northern . 
Europe. Also have an English Language book supplier service which includes C 
books. 


Seltec Computer Products Ltd., "Farley Hall", Wokingham Road, Bracknell, Berkshire, 
RG12 SEU: 


penne Distributors of Public Domain and Shareware products with a large 
range. 
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Appendix 6 
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Books 


Advanced Graphics in C Programming & Techniques, by N. Johnson, published by 
McGraw Hill. 


C from Á to Z, by B. Costales, pubished by Prentice Hall. 
The C Programmer's Handbook, by T Hogan, published by Prentice-Hall. 
C Programming Guide, by Purdum, published by Que. 


The C Programming Language by B. Kernighan and D. Ritchie, published by Prentice 
Hall. 


The C Toolbox, by W. J, Hunt, published by Addison Wesley. 
Computer Handbooks, C Language, by F. Wagner-Dobler, published by Pitman. 
Debugging C, by Ward, published by Que. 


Dr Dobb's Toolbook of C, by The Editors of Dr. Dobb's Journal, published by 
Prentice Hall. 


The Peter Norton Programmers Guide to the IBM PC, by P. Norton, Published by 
Microsoft Press. 


Solutions in C, by R. Jaeschke, published by Addison Wesley. 


System Management Under Unix, by N.G. Backhurst and P.Davies, published by 


Sigma Press 

| Refe s is not pyailabio to he Public being an 
MSDOS Technical Refe oft and their licencees. Many of the compute, 
internal document for Meo ut out their own version,of this document, One s 
manufacturers who use MSDOS p so if ypu manufacturer doeg E: 


ili :ers Reference Manual 
the best is Philips Programmers an | 
E t 


> / 1198 Vin ff x 
OFT] q U y ; A 
Universi idwar Collection; Digitized by S3 Foundation USA 


96 
i 
S 


| 
j 
| 
| 
| 
| 


produce a version for his implementation of MSDOS, try getting hold of the Philips 
copy. 


Magazines 


There are a number of magazines which contain interesting EE 2 C. as 
magazines though are generally recognized as being the as gee a D ed = 
unfortunately they are both American and in England can genera eS y sr 
subscription, though in Germany and Holland they can be purc 


shops and some newsagents. 


i A 94063, 
Dr Dobb's Journal of Software Tools - 501 Galveston Dr, Redwood City, C 


United States of America 

i i tes of 
Micro/Systems Journal - Box 3713, Escondido, CA 92025-9843, United Sta 
America 
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INDEX 


1, 57, 74, 215 
Iz, 57, 68 


#define, 27, 44, 250 
Helse, 249 

Wendif, 249 

#if, 249 

Hifdef, 249 

#ifndef, 249 

#include, 28, 41, 52, 132 
Wundef, 249 


70, 47, 57, 60, 89 
&, 29, 57, 73, 139, 140 


*/, 16 
*, 29, 57, 60, 89 
*char[ ], 132 


++, 57, 62, 64 
+, 57 
+,7, 89 


—, 57, 62, 64, 74, 75, 89, 95 
—>, 215 


/*, 16 
/, 57, 60, 89 


««, 150 
<, 57,70 
<=, 57,70 


==, 57, 68 
>, 57, 69 


>=, 57,70 
>>, 150 


\, 28, 181 


^, 147, 148 
|, 146, 147 
Il, 57, 73 
~, 65, 149 
absread(), 218, 224, 237 
ite, 2 
abswrile, 2 117 


addresses, 50 

AH,AL, 218, 219, 228 

alias, 27 

alloc.h, 184 

alphanumeric, 23 

Alt-R, 16 

American National Standard 
Institute, 5 

ampersand, 29 

and:, 75, 76 

and, 57 

AND, 73, 139, 147 

ANSI, 2, 38, 43, 163, 177, 

183, 282 

append mode, 126 

argc, 131, 134 

arguments, 14, 37, 103, 132, 
180 


argv, 131, 134 

argv[0], 132, 132 

array, 92, 170 

array of characters, 103 
array of pointers, 134, 153, 
array of structures, 174, 176 
array sets, 2 

ASCII text, 142 
assemblers, 1 

assign operator, 25 
asterisk, 29 

atoi( ), 135 

auto variable, 41 

AX, 218, 219 


backslash, 16, 46 
backspace, 16, 46 

basic actions, 12 

BCD, 178 

bdos( ), 224, 225 
bdosptr( ), 224 

Bell Vaboratories, 5 
BH, 219 

binary coded decimal, 178 
binary information, 136 
binary representation, 88 
BIOS, 217, 218 
bioskey( ), 229 

bit contents, 136 

bit level, 57 

bitfields, 177 

bitwise, 57, 230 
bitwise operators, 177 
bitwise shifts, 150 

BL, 219 

block, 7, 12, 44 

block languages, 9 
block structures, 12 
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break, 82, 155 
buffer, 108, 154 
buffer address, 119 
bugs, see debugging 
BX, 218, 219 

bytes, 20, 63, 136 


call, 7, 12 
calling function, 39 
calloc( ), 186, 188 
carriage return, 28, 46 
cast, 44, 158, 164 
casung, 163, 183, 

CH, 219 

char, 22, 98, 183, 219 
char*, 44 

character 'O', 60 
character value, 47 
character, 25 

CL, 219 

class, 41, 42 

close, 115 

CLS, 121, 122, 163 

code files, 139 

code macros, 76, 180, 258 
code tidies, 274 

COM1, 123 

command line, 132 
comment, 16 

comment, nested, 251 
commented, 59 
commenting style, 18 
compound statements, 14 
concatenation, 114 
condition, 66 
conditional compilation, 18, 

249 

conio.h, 54 

const modifier, 32, 33 
constant reference, 100 
constant values, 20 
continue, 85, 155 
control characters, 55 
control directives, 47 
control functions, 256, 254 
control statements, 2 
control string, 45, 48, 50 
coreleft( ), 185 

CPP.EXE, 271 

creat( ), 230 
cross-referencing, 272 
CROSSREF, 273 


CX, 218, 219 
data Clements, 190 
data types. 

debugging, 76, 88, 262 


decimal numbers, 22 
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declaration, 23 
declaring functions, 18 
declaring structures, 170 
declaring variables, 22 
decremental operator, 95 
define, 27 

defining constants, 22 
definitions, 52 
designated address, 50 
designation letter, 48 
device file, 123 

DH, DI 219 

direct access, 126 
disbits( ), 178 

divide, 89 

division operator, 60 
DL, 219 

do-while, 77, 78, 86, 118 
dos.h, 225 

DOS, 217, 218 

dummy getchar( ), 60 
DX, 218,219 

dynamic arrays, 153 


echo, 53 

egets( ), 157, 158 
else, 69 

empty condition, 86 
empty loop, 18 

end of file, 119 
endless loop, 55, 71 
entry point, 14, 35. 253 
EOF, 119 

equality operators, 68 
error checking, 43 
errors, 262, 270 


exit( ), 82, 142 
expressions, 7 
extended key code, 228 


false, 66, 69 

fclose( ), 116, 117, 120 
fcloseall( ), 120 

fentl.h, 230 

ffset, 93 

fgetc(), 116 

fgets(), 109, 116, 214 
field size, 48, 49 

file descriptor, 230 

file handling, 2 

file pointer, 117, 118, 119 
FILE, 121 A 
filepointer, 

flant, 22; 23, 158 

floating point numbers, 50 
floating point value, 47, 49 
flow conto us 35 
fopen(), 116, 

forloop, 51, 56, 81 

format control directives, 45 
format string, 4 


formfeed, 
fprint{(), 116, 118 


ic( ), 116 
ee ? 116, 119, 122, 128 


free(), 152, 185 
fscanf( ), 116, 118, 119 
fseek( ), 126, 128, 232 
ftell( ), 125, 126 
function calls, 180 
function name, 14 


functions, 35, 256, 357 


generic, 183 

geninterrupt( ) 224 

getc(), 118, 132 

getch( ), 228 

getchar( ), 4, 52, 62, 94, 155 
getche( ), 40, 52, 53 

gets( ), 106 - 9, 119, 154 - 7 
global, 35, 94, 164, 171 
goto, 167, 169 


header file, 180 
heading, 14 

heap, 183 
hexadecimal, 46, 164 
high bit, 142 

high level languages, 2 
high register, 218 


T/O routines, 6 

identifier, 23 

if..else statement, 69 

if, 66, 69, 155 

in-line code, 180 

include files, 154 

increases, 62 

incremental, 31, 57, 62, 81 

inequality, 87 

initialize variables, 27 

input/output, 52, 116 

instruction, 12 

int86( ), 225 

int, 22, 43, 134, 183, 219 

intdos( ), 225 

integer, 22, 25,92 

integer percent directive, 48 

integer value, 41, 228 

integer variables, 33, 60 

integrated development 
environment, 4 

interrupt 16, 221, 237 

intr( ), 225 

io.h, 230 

isalnum, 213 

isalpha, 213 


jumps, 7, 12, 86 


kbhit(), 54 
keyboard, 69 
keyword, 23, 40, 186 


LABELS, 167 

left justified, 48 

left shift, 150 

library functions, 105 
lineal approach, 9 

lineal languages, 9 

lineal program structure, 12 
linefeed, 46 

linked list, 189, 190, 203 
lint, 271 
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local, 35, 36 

local variable definitions, 14 
local variables, 35 
location, 12, 29 
logical, 57, 66 

long, 185 

loop, 9, 56, 155 
looping, 77 

low level languages, 2 
low register, 218 
lower case, 23 

lower level blocks, 12 
LPT1, 121, 123 
Iscek( ), 232 


macros, 180,258 

main( ), 14, 131, 164 

maintaining code, 7 

malloc( ), 152 - 155, 183 - 8 

man/hour effort, 4 

mathematics, 89 

memory address, 29 

memory allocations, 18 

memory management, 182 

memory, 20, 103, 152, 163 

mode, 117 

modem, 123 

modifier, 9, 32 * 

modularity, 253 - 

modulo operator, 60, 89 

MS-DOS, 4, 29, 122, 132, 
158, 188, 217, 


224 
MS-DOS interrupts, 237 
multi-dimensional array, 
100, 103 110 
multiple declaration, 25,26 
multiplication operator, 60, 
89 
multistatement lines, 3 


name, 23 

negation, 75 

nested comments, 18, 251 
newline, 46, 181 

nibbles, 177 

NORMAL, 163 

not equal, 68 

not true, 8 

NOT, 74, 75 


null type, 44 
NULL. 46, 119, 120, 153 
num, 155 


numeric values, 22 


octal, 46 

offset, 125, 126, 128 
OK(), 176 

one way linked list, 211 
ones-complement, 65, 149 


OP, 65 
open), 115, 120, 230, 232 


operating system, 11 
operational functions, 255 


imizing function, 3 
OR. 51, Ti 146, 147, 230 
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eter permissions, 230 
pattern, 170, 171, 176 
percent directives, 47, 48, 50 
placement, 63 
pointer, 29, 31, 41, 62, 100, 

= 158, 173, 183 
pointer initialization, 270 
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